API reference

Send batch

POST/api/v2/emails/batch

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, cc and bcc.
  • No attachments in batch requests: use Send email for those.