Send a broadcast
POST
/broadcasts/{id}/sendAutorización
AuthorizationToken Bearer · headerobligatorioA BillionSend API key (bs_…).
Parámetros de ruta
idstring<uuid>obligatorioCuerpo de la solicitud
application/jsonscheduled_atstringDeliver later: ISO 8601 with offset or relative like "in 1 hour"; omitted sends now
Respuestas
200
Broadcast scheduled; finishes_at and warning say when it goes out
idstring<uuid>obligatoriofinishes_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
Valores permitidos:
truewarningobjectMostrar propiedadesOcultar propiedades
codestringobligatoriopaced: more than the capacity available now; queued_behind: other sends go first
Valores permitidos:
pacedqueued_behinddaysintegerobligatorioDays the send spans
messagestringobligatorio400
Not a draft
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio401
Missing, malformed, unknown or revoked API key
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio403
Sending paused, or a From on the shared inbox domain
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio404
Not found
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio422
Validation error
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio