Bulk

Send marketing and bulk emails

Send marketing emails and newsletters through the bulk stream optimized for high-volume sending.

Learn more about Bulk Stream and when to use it.

Send bulk email

post

Send marketing emails and newsletters through the bulk stream optimized for high-volume sending.

Use cases:

• Marketing campaigns

• Newsletters

• Announcements

• Promotional emails

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Body

application/json

or

or

or

Responses

200

Bulk email successfully sent

application/json

successbooleanOptionalExample: true

message_idsstring[]Optional

Message IDs (one per recipient)

Example: 0c7fd939-02cf-11ed-88c2-0a58a9feac02

400

Bad request. Fix errors listed in response before retrying.

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

500

Internal server error. Retry later or contact support.

application/json

post

/api/send

cURLNode.jsPHPPythonRuby.NETJava

curl -X POST https://bulk.api.mailtrap.io/api/send \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": {"email": "[email protected]"},
    "to": [{"email": "[email protected]"}],
    "subject": "Monthly Newsletter",
    "html": "<h1>Our Latest Updates</h1>",
    "category": "newsletter"
  }'

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

Batch send emails

post

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

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

cURLNode.jsPHPPythonRuby.NETJava

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

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