Send a broadcast
POST
/broadcasts/{id}/sendAuthorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
idstring<uuid>requiredRequest body
application/jsonscheduled_atstringDeliver later: ISO 8601 with offset or relative like "in 1 hour"; omitted sends now
Responses
200
Broadcast scheduled; finishes_at and warning say when it goes out
idstring<uuid>requiredfinishes_atstring | nullWhen the last email is expected to go out (ISO 8601); null when unknown
estimatedbooleanfinishes_at is an estimate that moves as other sends come in
Allowed:
truewarningobjectShow propertiesHide properties
codestringrequiredpaced: more than the capacity available now; queued_behind: other sends go first
Allowed:
pacedqueued_behinddaysintegerrequiredDays the send spans
messagestringrequired400
Not a draft
statusCodenumberrequirednamestringrequiredmessagestringrequired401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired403
Sending paused, or a From on the shared inbox domain
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired