Skip to documentation

Emails

Schedule email

Queue an email for a future time.

How it works

Queue an email for a future time. Set scheduled_at using ISO 8601 or a supported natural-language expression. Use PATCH on the email ID to reschedule, or POST to its cancel endpoint.

Example

json
{"scheduled_at":"in 1 hour"}

Things to know

Schedules can be at most 30 days ahead. Expressions without a timezone use UTC. Past send times queue immediately; rescheduling requires a future time. Once an email leaves the schedule for the send queue, reschedule and cancel return 422.