Authentication

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

How to authenticate HTTP requests to Mailtrap APIs

There are several ways to send authenticated HTTP requests:

Send a HTTP header Api-Token: {api_token}, where {api_token} is your API token

You can manage your API token on the API Tokens page. API token does not have an expiration date, you may reset it manually.

All requests must be sent over HTTPS protocol.

Allowed HTTP requests include:

Get a resource or a list of resources

Here is the description of common server responses:

The request was successful (some API calls may return 201 instead)

The request was successful but there is no representation to return (i.e. the response is empty)

Authentication failed or user doesn't have permissions for requested operation

Requested data contain invalid values

Rate limit exceeded. Reduce request frequency and retry later