> For the complete documentation index, see [llms.txt](https://docs.mailtrap.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mailtrap.io/email-api-smtp/help/faqs.md).

# FAQs

Frequently asked questions about Mailtrap Email API/SMTP.

This page covers frequently asked questions about Mailtrap Email API/SMTP. For technical issues and error troubleshooting, see the [Troubleshooting section](/email-api-smtp/help/troubleshooting.md).

#### Getting started

<details>

<summary>What is Mailtrap?</summary>

Mailtrap is an email delivery service to send transactional and promotional emails. Popular among developer and product teams for its Email API and SMTP solutions.

</details>

<details>

<summary>How do I integrate Mailtrap with my application?</summary>

1. [Sign up](https://mailtrap.io/register/signup/) for an account.&#x20;
2. Go to Email Sending and select [Sending Domains](https://mailtrap.io/domains).
3. After you've added and verified all the DNS records, wait for the Compliance Check to be completed.
4. Navigate to the [**Sending Setup**](https://mailtrap.io/api-smtp/sending-setup) page and integrate Mailtrap with your application via API, SMTP, or your AI agent.

Learn more:

* [API Integration](/email-api-smtp/setup/api-integration.md)
* [SMTP Integration](/email-api-smtp/setup/smtp-integration.md)
* [Sending Domain Setup](/email-api-smtp/setup/sending-domain.md)

If you have any questions, contact us at <support@mailtrap.io>.

**Important**: Make sure the address of the account owner is actively monitored. If we detect suspicious sending activity or need to clarify any important account details, we may contact you at this email address to ask additional questions, which helps avoid unnecessary account restrictions.

</details>

<details>

<summary>Can I send emails without my domain?</summary>

No, you can't.

To send emails, Mailtrap requires you to add a sending domain, authenticated and verified using the DNS records Mailtrap provides.

</details>

<details>

<summary>Can I send emails on behalf of other domains?</summary>

No, you can't.

If you verified mydomain.com, you can send emails only on behalf of your domain.

</details>

#### Domain setup

<details>

<summary>Should I use my domain name with www. ?</summary>

No, you should use your domain without it.

Please check our [Sending Domain Setup Guide](/email-api-smtp/setup/sending-domain.md) for detailed instructions on adding and verifying your domain.

</details>

<details>

<summary>When I add a domain to Mailtrap, does that include subdomains?</summary>

No, you need to add and verify each subdomain/domain separately.

</details>

<details>

<summary>Do I need to verify all domains mentioned in my emails?</summary>

If your emails mention, promote, or link to another domain that belongs to you, your company, or your client, then you need to add that domain to Sending Domains and verify it as well.&#x20;

This helps us verify that the domains are connected to the same legitimate sender and prevents your emails from being mistaken for phishing. If you cannot add it due to the domains limit in your sending plan, please contact the support team for assistance.

</details>

#### Features & capabilities

<details>

<summary>Can I receive emails with Mailtrap?</summary>

Yes, you can. Mailtrap offers the Inbound Email API, which allows you to create inboxes on demand, receive emails via API or webhooks, and process attachments securely. You can also receive mail at your own domain: verify it in Mailtrap, add the MX record we provide, then create a catch-all inbox that collects every address at that domain.

</details>

<details>

<summary>Can I send emails to end-users with Mailtrap?</summary>

Yes, you can. Mailtrap is an email delivery service to send transactional and promotional emails. Popular among developer and product teams for its Email API and SMTP solutions.

</details>

<details>

<summary>Can I force an encrypted connection?</summary>

Yes, you can enforce encrypted connections. Mailtrap SMTP server uses STARTTLS, which works for all SMTP ports. We support only TLS connections because of the POODLE vulnerability (SSLv2 and SSLv3 are disabled).

</details>

<details>

<summary>I would like to whitelist live.smtp.mailtrap.io on my firewall. What is Mailtrap's IP range?</summary>

We use AWS with auto-balancing, so our IP ranges are the following: <https://ip-ranges.amazonaws.com/ip-ranges.json>

</details>

<details>

<summary>Can I send emails via JavaMailSender?</summary>

Yes, Mailtrap works with Spring’s JavaMailSender through SMTP. Simply add `spring-boot-starter-mail` to your project, then copy the SMTP credentials from your sending domain’s Integration tab into the `spring.mail`.

```java
spring.mail.host=live.smtp.mailtrap.io
spring.mail.port=587
spring.mail.username=api
spring.mail.password=YOUR_SMTP_PASSWORD
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
```

</details>

#### Billing & limits

<details>

<summary>How does Mailtrap billing work?</summary>

We bill each email. For example, if an email has 3 recipients - we bill 3 of them. If it has + 3 in CC, we bill 6 together. The same goes for recipients in BCC.

</details>

<details>

<summary>What is the email size limit?</summary>

The maximum size of an email with attachments for Mailtrap is 10 MB. Upon request, we can extend the limit in some cases to 30 MB.

</details>

<details>

<summary>What is the monthly message limit for email sending?</summary>

It's the maximum number of emails you can send with Mailtrap per month. The total number of emails per month depends on the subscription plan.

If you reach your monthly limit, you'll receive the SMTP protocol error: "535 5.7.0 Monthly messages limit reached". We also send out notifications for having used 80%, 90%, and 100% of the monthly limit.

To continue sending when you're over the limit, please upgrade your subscription plan. Alternatively, you can wait until the next billing period starts, when the limit is reset.

For more details, check the [Sending Limits](/email-api-smtp/setup/sending-limits.md) and [Pricing page](https://mailtrap.io/pricing/?tab=api).

</details>

<details>

<summary>How much does Mailtrap cost?</summary>

Mailtrap offers flexible pricing plans that scale with your email volume, from starter plans for small projects to enterprise solutions for high-volume senders.

For current pricing and to choose a plan that best fits your needs, visit our [pricing page](https://mailtrap.io/pricing/?tab=api).

</details>

#### Data & privacy

<details>

<summary>Is it possible to export Email logs?</summary>

Yes, you can export Email Logs by going to **Email API/SMTP** → **Email Logs** and clicking on **Export in CSV**. You will then receive a CSV file containing your Email Logs in your inbox.

<figure><img src="https://1476453098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS3xyr7ba7aGO19rc8dSK%2Fuploads%2FTl3U6RSw7E99cSpwAnZv%2FScreenshot%202026-09-23%20at%2011.23.42.png?alt=media&amp;token=e1fc7f2f-51a5-4da9-8393-e17f8a1549b1" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Does Mailtrap comply with the GDPR?</summary>

The General Data Protection Regulation (GDPR) came into effect on May 25, 2018. We have implemented appropriate technical and security processes to ensure Mailtrap's full compliance with this regulation.

For more details, refer to our:

* [Privacy Policy](https://mailtrap.io/privacy/)
* [Navigational Information](https://mailtrap.io/navigational-info/)
* [Data Protection Agreement](https://mailtrap.io/dpa/)

</details>

<details>

<summary>Do you have a bug bounty program?</summary>

We do not. In case you have found a vulnerability on our website that you are eager to report to us, you are welcome to do so at <support@mailtrap.io>. All issue reporters will be mentioned on our [changelog page](https://mailtrap.io/changelog/).

</details>

{% hint style="info" %}
Haven't found what you're looking for? Feel free to ask over at [Mailtrap Community](https://community.mailtrap.io/). We're happy to help!
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mailtrap.io/email-api-smtp/help/faqs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.