Batch sending

How it works

Send between 1 and 100 messages in one request. POST an array to /emails/batch. The default strict mode validates and queues the whole batch in one transaction.

Example

[{"from":"hello@example.com","to":"you@example.net","subject":"Welcome","text":"Hello"}]

Things to know

In strict mode, a validation failure queues none. Set the x-batch-validation header to permissive to queue valid messages and return errors with index and message for invalid rows. A fully successful permissive response has an empty errors array. Templates, topics, and schedules are supported; attachments are rejected. The default 1 MiB request-body limit applies to batches.