Skip to main content
POST
Schedule a message

Authorizations

x-api-key
string
header
default:bd_live_your_key_here
required

Body

application/json
leadId
string
required

The lead to message (must already have a conversation)

text
string
required

The message text

Maximum string length: 8000
fireAt
string
required

When to send (ISO 8601). Must be 60s–90 days in the future. Counts against the daily per-account send budget.

Example:

"2026-06-19T09:00:00Z"

Response

scheduledMessageId
string
required

The scheduled message id

chatId
string
required

The conversation it will be sent to

fireAt
string<date-time>
required

When it will fire

status
string
required

The status

Example:

"PENDING"