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

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Body

application/json

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

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://send.api.mailtrap.io/api/send \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": {"email": "[e-mail]"},
    "to": [{"email": "[e-mail]"}],
    "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

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://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"
  ]
}