POST /broadcasts/{id}/send

Send now. Content is SNAPSHOTTED: the segment is evaluated and every member rendered with their properties; the result is immutable.

Parameters

id path · string · required
Idempotency-Key header · string · optional — Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request).

ratelimit-limit — Messages this API key may spend in one 60-second window.
ratelimit-remaining — Messages left in the current window.
ratelimit-reset — Seconds until the current window resets and the budget refills.

Field	Type	Required
broadcast	object	yes
broadcast.archived_at	string \| null	yes
broadcast.content	object \| null	yes
broadcast.created_at	string	yes
broadcast.from_address	string \| null	yes
broadcast.id	string	yes
broadcast.name	string	yes
broadcast.scheduled_at	string \| null	yes
broadcast.segment_id	string \| null	yes
broadcast.sent_at	string \| null	yes
broadcast.sent_count	integer	yes
broadcast.status	string	yes
broadcast.subject	string \| null	yes
broadcast.template_id	string \| null	yes
broadcast.updated_at	string	yes
sent	integer	yes
skipped	integer	yes

Codes in the catalogue that answer with one of this operation’s error statuses. Every one of them carries a fix.