Batch send emails

Send up to 500 transactional emails in a single API call. Each email can have unique recipients and content while sharing base properties.

Limits:

• Maximum 500 messages per call

• Maximum 50 MB total payload size (including attachments)

Note: The endpoint returns HTTP 200 even if individual messages fail. Check the responses array for individual message status.

post

Authorizations

Api-TokenstringRequired

API token in Api-Token header

Body

Send multiple emails in a single API call (up to 500)

Responses

200

Batch processed. Check individual responses for delivery status.

application/json

successbooleanOptional

Overall request success

Example: true

errorsstring[]Optional

General errors

400

Bad request. Fix errors listed in response before retrying.

application/json

401

Unauthorized. Check your API credentials.

application/json

500

Internal server error. Retry later or contact support.

application/json

post/api/batch

curl -X POST https://send.api.mailtrap.io/api/batch \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "base": {
      "from": {"email": "[e-mail]"},
      "subject": "Monthly Newsletter"
    },
    "requests": [
      {"to": [{"email": "[e-mail]"}]},
      {"to": [{"email": "[e-mail]"}]},
      {"to": [{"email": "[e-mail]"}]}
    ]
  }'

{
  "success": true,
  "responses": [
    {
      "success": true,
      "message_ids": [
        "0c7fd939-02cf-11ed-88c2-0a58a9feac02"
      ],
      "errors": [
        "text"
      ]
    }
  ],
  "errors": [
    "text"
  ]
}