Sends up to 100 emails in one request, each with its own recipients and content. Works with sending and full keys.
Body
A JSON array of email objects. Each object takes the same fields as Send email, except attachments, which are not supported in batches.
curl -X POST https://robustemail.com/api/v2/emails/batch \
-H "Authorization: Bearer $ROBUSTEMAIL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: digest-2026-10-25" \
-d '[
{
"from": "Acme <hello@acme.com>",
"to": "jane@example.com",
"subject": "Your weekly summary",
"html": "<p>Hi Jane, here is your week.</p>"
},
{
"from": "Acme <hello@acme.com>",
"to": "sam@example.com",
"subject": "Your weekly summary",
"html": "<p>Hi Sam, here is your week.</p>"
}
]'
Response
The IDs, in the same order as the emails you sent:
{
"data": [
{ "id": "6adc79043cbea" },
{ "id": "6adc79043cbeb" }
]
}
Validation
The whole batch is checked before anything is queued. If one email is invalid, nothing is sent and the error names the item, for example:
{
"statusCode": 422,
"name": "validation_error",
"message": "emails[1]: The `subject` field is required."
}
Idempotency
With an Idempotency-Key, each email in the batch is remembered by its position. Retrying the same batch with the same key returns the same IDs without sending again. See Idempotency.
Limits
- Up to 100 emails per request.
- Up to 50 recipients per email across
to,ccandbcc. - No attachments in batch requests: use Send email for those.