Mailtrap’s Upcoming API Changes

At present, Mailtrap uses one database to store all application data. As a result, a large number of BLOBs (binary large objects), which the application sends and catches, negatively affect the overall system’s performance. Besides, having just one database does not allow us to increase the size limit of an email message (the current limit is 5MB).

That is why we are planning to move all BLOBs to separate storage. This transition will lead to Mailtrap’s API changes:

  • The “html_body” and “text_body” fields will be removed from the Mailtrap’s API.
  • They will be still available through the “path” fields via an extra API call.


Mailtrap's API Before the Changes
Mailtrap’s API Before the Changes


Mailtrap's API After the Changes
Mailtrap’s API After the Changes

Timeline of Mailtrap’s API Changes

  • September 1st, 2018: “html_body” and “text_body” fields will be present in the response, but will be replaced by a deprecation warning.
  • December 1st, 2018: “html_body” and “text_body” fields will be removed from API.
Join our newsletterOnly the best content, delivered once a month. Unsubscribe anytime.

Frequently Asked Questions

Q1: Why not create a V2 of the API?

Even if we create version 2 of the API, we won’t be able to maintain version 1 for a long time, because using two different storage systems won’t allow us to provide the “html_body” and “text_body” fields. In the end, leaving v1 will inevitably lead to “2*N + 1 issue” that we cannot allow happening.

Q2: Where should I get a non-modified (raw) version of HTML from an email message?

This data is available via the “html_source_path” link in the message.

For additional questions, feel free to address them to

Add comment

E-mail is already registered on the site. Please use the Login form or enter another.

You entered an incorrect username or password

Sorry, you must be logged in to post a comment.