Send Email - Batch

Send up to 500 emails in a single request

Efficiently send multiple emails with shared content but different recipients.

SDK Usage: To send via Bulk Stream using SDKs, add bulk: true to your client configuration.

Limits: 500 messages per API call, 50 MB total payload size

Batch send emails

post

https://send.api.mailtrap.iohttps://bulk.api.mailtrap.io

/api/batch

Send up to 500 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.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Body

application/json

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

Responses

200

Batch processed. Check individual responses for delivery status.

application/json

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

Node.jsPHPPythonRuby.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY
  // Add bulk: true for Bulk Stream
});

const response = await client.batchSend({
  base: {
    from: { email: "[email protected]" },
    subject: "Important Update",
    text: "Hello {{name}}, we have news for you."
  },
  requests: [
    {
      to: [{ email: "[email protected]" }],
      custom_variables: { name: "Alice" }
    },
    {
      to: [{ email: "[email protected]" }],
      custom_variables: { name: "Bob" }
    }
  ]
});

response.responses.forEach((result, index) => {
  if (result.success) {
    console.log(`Email ${index + 1} sent`);
  }
});

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