Sign in

v53

OpenAPI 3.0.1raw.githubusercontent.com2026-07-31147343479.6 KB
Broadcasts

Send Broadcast

Send a broadcast immediately to a list or audience. Publishes the broadcast template first. Not allowed once the broadcast is sending or sent.

post/broadcasts/{broadcastId}/send

Path parameters

broadcastIdstring required

Request body

recipient_type'list' | 'audience' required

Whether the broadcast targets a list or an audience.

recipient_idstring required

ID of the target list or audience.

Response

idstring required

The broadcast ID (bst_ prefix).

namestring required

Human-readable name.

channel'email' | 'sms' | 'push' | 'inbox' | 'slack' | 'msteams' required

The broadcast's delivery channel.

status'draft' | 'scheduled' | 'sending' | 'sent' required

Lifecycle status of the broadcast.

created_atstring required

ISO 8601 timestamp when the broadcast was created.

updated_atstring required

ISO 8601 timestamp of the last update.

created_bystring required

Actor that created the broadcast.

updated_bystring required

Actor that last updated the broadcast.

archived_atstring nullable

ISO 8601 timestamp when the broadcast was archived, if archived.

archived_bystring nullable

Actor that archived the broadcast, if archived.