Send batch emails
POST/emails/batch
Send a single email to up to 100 recipients in one request. Each recipient gets their own message record. Provide either raw content (subject plus html and/or text) or a template_id with template_data. Per-recipient variables are merged on top of the batch-level template_data.
Request
Responses
- 202
- 400
- 403
- 413
- 429
Batch accepted
Response Headers
The account's current sending state. Present on every authenticated response. One of active, throttled, or frozen.
Human-readable reason for a non-active sending status. Present only when X-Account-Sending-Status is throttled or frozen.
Validation error
The account is frozen for sending (reputation). Only send-capable endpoints return this; reads/billing/deliverability stay available. The error message carries the freeze reason.
Response Headers
The account's current sending state. Present on every authenticated response. One of active, throttled, or frozen.
Human-readable reason for a non-active sending status. Present only when X-Account-Sending-Status is throttled or frozen.
Request body exceeds the maximum allowed size (currently 25 MB). See https://zyphr.dev/resources/api-limits for limits and guidance.
The account is throttled for sending (reputation). Only send-capable endpoints return this. The error message carries the throttle reason.
Response Headers
The account's current sending state. Present on every authenticated response. One of active, throttled, or frozen.
Human-readable reason for a non-active sending status. Present only when X-Account-Sending-Status is throttled or frozen.