Messaging

Send messages to individuals, teams, or channels through Dailybot. These endpoints support text messages, images, buttons, and email delivery. Messages are delivered through the platform your organization uses (Slack, Microsoft Teams, Google Chat, or Dailybot's native chat).

Method	Endpoint	Description
POST	/v1/send-message/	Send a message to users, teams, or channels
POST	/v1/send-email/	Send an email to users by UUID
POST	/v1/open-conversation/	Create a private group conversation

Send Message

POST /v1/send-message/

Delivers a message to specified users, teams, or channels. At least one target (users, teams, or channels) must be provided.

Body Parameters

Name	Type	Required	Description
`message`	string	Optional	Message text (HTML-safe). Required if messages is not provided.
`messages`	array	Optional	Platform-specific messages. Required if message is not provided.
`target_users`	array of strings (UUID)	Optional	User UUIDs to receive the message.
`target_teams`	array of strings (UUID)	Optional	Team UUIDs; all members receive the message.
`target_channels`	array	Optional	Channel IDs and options (structure defined by the API).
`bot_message_id`	string	Optional	Custom message ID for tracking or idempotency. If omitted, the API returns a generated ID.
`buttons`	array	Optional	Interactive buttons.
`image_url`	string	Optional	Image URL to attach.
`platform_settings`	object	Optional	Platform-specific settings.
`metadata`	object	Optional	Custom metadata.
`skip_users_on_time_off`	boolean	Optional	If true, do not send to users on time off.

Request

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Deployment completed successfully! ✅",
    "target_users": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "target_teams": ["b2c3d4e5-f6a7-8901-bcde-f12345678901"]
  }'

Response 200 OK

json

{
  "bot_message_id": "$db/ae007b43-dde2-4fa9-bce3-71fb0975a249"
}

bot_message_id (string) — Either the ID sent in the request or a server-generated task ID in the form $db/<uuid>. Use it for tracking or idempotency.

Response 403 Forbidden

json

{
  "detail": "Invalid or missing API key.",
  "code": "authentication_failed"
}

Missing or invalid API key.

Info

At least one of target_users, target_channels, or target_teams must be provided.

Tip

You can target multiple users, teams, and channels in a single request. The message will be delivered to all specified targets.

Send Email

POST /v1/send-email/

Sends an email to the specified users (by user UUID).

Body Parameters

Name	Type	Required	Description
`users_uuids`	array of strings (UUID)	Required	User UUIDs to receive the email.
`email_subject`	string	Required	Subject of the email.
`email_content`	string	Required	Body of the email (HTML or plain text).

Request

curl -X POST "https://api.dailybot.com/v1/send-email/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "users_uuids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "email_subject": "Weekly Report Ready",
    "email_content": "Your weekly team report is now available. Check your dashboard."
  }'

Response 200 OK

json

{
  "detail": "Emails sent successfully."
}

detail (string) — Success message.

Response 400 Bad Request

json

{
  "detail": "one_or_more_users_not_found",
  "code": "one_or_more_users_not_found"
}

One or more user UUIDs not found.

Response 403 Forbidden

json

{
  "detail": "Invalid or missing API key.",
  "code": "authentication_failed"
}

Missing or invalid API key.

Open Conversation

POST /v1/open-conversation/

Creates a private group conversation (e.g. in Slack) with the specified users.

Body Parameters

Name	Type	Required	Description
`users_uuids`	array of strings (UUID)	Required	User UUIDs to include in the conversation.

Request

curl -X POST "https://api.dailybot.com/v1/open-conversation/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "users_uuids": [
      "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "b2c3d4e5-f6a7-8901-bcde-f12345678901"
    ]
  }'

Response 200 OK

json

{
  "channel": "C0123456789"
}

channel (string) — The platform channel ID (e.g. Slack channel ID).

Response 400 Bad Request

json

{
  "detail": "one_or_more_users_not_found",
  "code": "one_or_more_users_not_found"
}

One or more user UUIDs not found in the organization.

Response 403 Forbidden

json

{
  "detail": "Invalid or missing API key.",
  "code": "authentication_failed"
}

Missing or invalid API key.

Info

The Open Conversation endpoint is currently available only for organizations using Slack as their platform.