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

Transactional

Send individual transactional emails

Send transactional emails for order confirmations, password resets, and notifications.

Best for: Real-time, one-to-one emails triggered by user actions

Send transactional email

post

Send a single transactional email with text, HTML, or template content.

Use this endpoint for:

  • Order confirmations

  • Password reset emails

  • Account notifications

  • Welcome emails

  • System alerts

Authorizations
Api-TokenstringRequired

API token in Api-Token header

Body
or
or
or
Responses
200

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://send.api.mailtrap.io/api/send \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": {"email": "sender@example.com"},
    "to": [{"email": "recipient@example.com"}],
    "subject": "Hello from Mailtrap",
    "text": "Welcome to Mailtrap!"
  }'

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

Batch send emails

post

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.

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://send.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"
  ]
}
PreviousOpenAPI Specs
NextBulk

Last updated

Was this helpful?