Ctrlk
ProductPricingContact supportOpen app
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
Api-TokenstringRequired

API token in Api-Token header

Body
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
post/api/send
curl -X POST https://bulk.api.mailtrap.io/api/send \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": {"email": "marketing@example.com"},
    "to": [{"email": "subscriber@example.com"}],
    "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
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

post/api/batch
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": "sender@example.com"},
      "subject": "Monthly Newsletter"
    },
    "requests": [
      {"to": [{"email": "user1@example.com"}]},
      {"to": [{"email": "user2@example.com"}]},
      {"to": [{"email": "user3@example.com"}]}
    ]
  }'

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

Last updated

Was this helpful?