Send Broadcast

Schedule an existing broadcast for sending.

Use Cases:

• Send a fully prepared broadcast
• Trigger delivery of a queued broadcast
• Initiate campaign delivery after review

Behavior:

• Performs readiness checks before scheduling
• Verifies email content is complete (subject, HTML)
• Verifies sending domain is configured and verified
• Checks that send time is set
• Queues the broadcast for delivery at the scheduled time
• Broadcast status transitions to QUEUED_FOR_SENDING
• Triggers a broadcast.scheduled webhook event

Required Scope: write:broadcasts

Prerequisites:

• Broadcast must be in DRAFT status
• Email content must include subject and HTML
• Sending domain must be verified
• Send time (sendAt) must be set on the broadcast

Readiness Checks:
The endpoint validates the following before scheduling:

1. Email subject is present
2. HTML content is present
3. From address is set and domain is verified
4. Send time is configured

If any check fails, a 400 error is returned with details about what is missing.

Note: The broadcast is processed approximately 5 minutes before the scheduled send time to allow for recipient resolution and batching.