messaging

Schedule a message

Schedule a message to a lead’s conversation for a future time (60s–90 days). Counts against the daily per-account budget.

post/v1/messages/schedule

Request

  • Base URL: https://api.botdog.co
  • URL: https://api.botdog.co/v1/messages/schedule
  • Auth: API key in header x-api-key

Request body

leadIdstring required

The lead to message (must already have a conversation)

textstring required

The message text

fireAtstring required

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

Example request

{
  "fireAt": "2026-06-19T09:00:00Z"
}

Response

scheduledMessageIdstring required

The scheduled message id

chatIdstring required

The conversation it will be sent to

fireAtstring date-time required

When it will fire

statusstring required

The status

Example response

{
  "status": "PENDING"
}

Changes

No recorded changes to this operation across all 1 revision of this API.