Send Test Emails

Send emails to sandbox

Test Emails

Send email (including templates)

post

Send email message to the specified inbox.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

inbox_idinteger · int64 · min: 1Required

Unique inbox ID

Example: 4015

Body

application/json

or

or

or

Responses

200

Success. Message has been delivered.

application/json

successbooleanOptionalExample: true

message_idsstring[]Optional

An array of message IDs, one per recipient, in order of To, Cc, Bcc

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

400

Bad request. Fix errors listed in response before retrying.

application/json

401

Unauthorized. Make sure you are sending correct credentials with the request before retrying.

application/json

429

Billing plan limit exhausted or inbox rate limit exceeded (see the response for details).

application/json

500

Internal error. Mail was not delivered. Retry later or contact support.

application/json

post

/api/send/{inbox_id}

cURLNode.jsPHPPythonRuby.NETJava

curl -X POST https://sandbox.api.mailtrap.io/api/send/{inbox_id} \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": {"email": "[email protected]"},
    "to": [{"email": "[email protected]"}],
    "subject": "Test Email",
    "text": "This is a test email sent to sandbox"
  }'

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

Batch send email (including templates)

post

Batch send email (text, html, text&html, templates). Please note that the endpoint will return a 200-level http status, even when sending for individual messages may fail. Users of this endpoint should check the success and errors for each message in the response (the results are ordered the same as the original messages - requests). Please note that the endpoint accepts up to 500 messages per API call, and up to 50 MB payload size, including attachments.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

inbox_idinteger · int64 · min: 1Required

Unique inbox ID

Example: 4015

Body

application/json

Responses

200

Success. Check individual responses if messages have been delivered.

application/json

successbooleanOptional

Indicates whether the was a general error. When false, you should check the errors array for information. When true, you should check individual message responses and their success.

Example: true

errorsstring[]Optional

General request errors.

400

Bad request. Fix errors listed in response before retrying.

application/json

401

Unauthorized. Make sure you are sending correct credentials with the request before retrying.

application/json

500

Internal error. Messages were not delivered. Retry later or contact support.

application/json

post

/api/batch/{inbox_id}

cURLNode.jsPHPPythonRuby.NETJava

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

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