Sending Domain Setup

In this article:

• Demo Domain
• Setting up your own domain 
  • Add Domain
  • Domain Verification 
  • Compliance Check 
• Integration
• Tracking Settings 
• Unsubscribe Settings 
• Webhooks
• Sending Domains

To start sending emails with Mailtrap Email Sending to your recipients, you first need to add and verify your domain. Until your domain is verified, you can send emails only to the email address of the account owner. 

Demo Domain 

When you first sign up for Mailtrap Email Sending, a demo domain is created automatically. The demo domain is similar for all users and is meant to help you try out the features of the platform. 

With a demo domain, you can send emails only to the email address of the account owner. To send emails to your recipients, you need to add and verify a domain you own.  

The demo domain has all the DNS records already verified, so you can skip right to Integration. 

Setting up your own domain 

Step 1: Add Domain 

1. Navigate to Sending Domains in the left navigation panel. 

2. Click Add Domain. 

3. Type in the domain from which you want to send emails and click Add. Remember that you should be the domain owner with access to its DNS records/have someone with access to DNS records. 

4. After this step, you’ll see the Domain Verification page. 

Step 2: Domain Verification  

At this stage, you need to verify the domain. You have two options: 

• Send domain verification instructions to your admin or developer;
• Or verify the domain yourself if you have access to your domain’s DNS records (your domain provider account). 

To send instructions to your admin or developer, enter their email address and click Send Instructions. 

In the example below, we’ll be using GoDaddy. Detailed instructions for other popular providers are covered in separate articles. 

• GoDaddy 
• Cloudflare
• Namecheap
• Google Domains
• Google Cloud DNS
• AWS Route 53
• Digital Ocean

To verify the domain yourself, follow these steps: 

1. Go to your domain provider and locate the domain you’ve added to Mailtrap. 

2. Open the DNS settings and click Add New Record. 

3. Return to Mailtrap. On the Domain Verification page, you’ll see the DNS records you need to add to your domain provider. These are Domain Verification, DKIM, SPF, DMARC, and Domain Tracking. You’ll need the values under Type, Name, and Value. The namings of these records in Mailtrap are the same as in most domain providers but may differ slightly depending on the provider. 

• Make sure you check the type next to each record in Mailtrap and choose a relevant one in your domain provider. There are four CNAME type records (Domain Verification, DKIM (2), and Custom Tracking Domain) and two TXT type records (SPF and DMARC). Read this article for detailed information on each DNS record. 

• Note that you should have only one SPF record. So, if you already have one for your domain, update its value to include Mailtrap. It’s okay to have multiple DMARC records. 

4. Copy the Name and Value for each record one by one. You can do this by hovering and clicking each record. 

5. Paste them into your domain provider. 

6. Click Save after adding each record in your domain provider. 
7. Repeat the process of copying and pasting for each record until you’ve added all the Mailtrap DNS records to your domain provider. 

8. Then, return to Mailtrap. Some records may be verified immediately, while some may take more time. Mailtrap will check the DNS records automatically every hour, but you can force a check by clicking the Re-check DNS Records button.

9. If you add all the required DNS records correctly, the Status of DNS records will change from Missing to Verified, and the red dots will turn green. 

10. Once the DNS records are verified, you’ll be taken to the next step - Compliance Check.  

Several notes:

• Some domain providers don't allow setting ‘@’ for SPF records. In this case, please use your own domain name "example.com" instead of '@'.
• Some domain providers require a postfix format of the DKIM record. If that’s the case, replace rwmt1._domainkey with rwmt1._domainkey.yourdomain.com . Repeat the process for rwmt2._domainkey , changing the name to rwmt2._domainkey.yourdomain.com .
• If you’re asked to set TTL, use the default value as indicated under the TTL field on the Domain Verification page in Mailtrap. 

Step 3: Compliance Check

Compliance Check is a process of checking every new domain added to Mailtrap. 

Once all the DNS records are successfully verified, your domain will undergo an automatic review. This usually takes a couple of minutes. If your domain is verified at this stage, you’ll see the Verified badge next to your domain and below Compliance Check, and you’ll be able to start sending the emails. You’ll also receive an email informing you that your domain is ready for sending emails. 

Some domains may be selected for additional checks. If so, we’ll ask you to fill out a simple Compliance Form and answer a few questions about your business, sending goals, etc. You’ll see a notification under Compliance Check and a link to the form. 

We’ll email you if we need additional information from you. If all the checks are successful at this stage, your domain will be verified. 

In some cases, your domain may be selected for manual verification. This is the final check before your domain is verified. The length of the manual verification depends on how fast you reply to our emails. If successful, you’ll see Verified status. If not, you’ll see a Rejected badge next to your domain and a message under Compliance Check. In case of any questions about the reasons for rejection, please contact our support team at support@mailtrap.io. 

Integration 

Until the verification is completed, or if you’re using a demo domain, you can go to the Integration tab and configure your app or project to send emails via Mailtrap. 

To find instructions on SMTP integration, read this guide.

For API integration, refer to this article. 

(Optional) Tracking Settings

An optional step is to change the tracking settings. By default, Mailtrap tracks email opens for each email sent. You can also enable click tracking. 

Note: Click tracking and custom domain for clicks tracking are available only for paid accounts. 

With tracking enabled, you will find the open and click rates in the Analytics reports. Read this article for a detailed breakdown of Statistics. 

1. Navigate to the Tracking Settings tab. 

2. Toggle the switch next to Track Opened Emails to enable or disable tracking opens. Mailtrap tracks email opens via an invisible pixel. It’s added to each message sent from your account. When an email is opened, a pixel is loaded, and an ‘open’ event is recorded. Each of these events will be visible in Email Logs. Note: Some mailbox providers, browsers, and extensions block invisible pixels. Users can also choose not to display images, or a solution they use to retrieve emails may not support images by default. In each of these cases, an ‘open’ event won’t be recorded even if an email is opened.

3. If you're a paid user, toggle the switch next to Track Clicks to enable or disable tracking clicks. If you enable click tracking, the toggle for Custom Domain for Clicks Tracking will be switched on automatically. That way, all links will be redirected through your domain (mt-link.yourdomain.com). And if you verified all the records correctly in Step 2, Domain Tracking will also be verified and ready to use. 

Unsubscribe Settings

You can also configure unsubscribe settings. 

Unsubscribe links are mandatory for bulk emails as per privacy laws. If your emails don’t include an unsubscribe link, Mailtrap will add an Unsubscribe Footer automatically. This is what it will look like: 

To add an unsubscribe link anywhere in your template, include this tag in your HTML template: <a href="__unsubscribe_url__">unsubscribe</a> . Mailtrap will render a clickable link in your email. 

Unsubscribe Footer and Links are optional for transactional emails and are switched off by default. 

However, if you want to, you can still add an Unsubscribe Footer to your transactional emails by toggling the switch On under Unsubscribe Footer for Transactional emails or adding an HTML tag mentioned above. 

If you’d like, you can mix both approaches - automatically add a footer to emails sent from one domain and do it manually (when applicable) for emails sent from another domain.

If an end-user uses an unsubscribe link, Mailtrap will reject any future emails sent to this address from this particular domain. You can quickly find all such emails in the Email Logs by filtering by a “reject” event.

You will still be able to email them using other domains or subdomains added to your Mailtrap account. 

For that reason, it’s worth having different domains or subdomains for different types of emails. This way, users can, for example, unsubscribe from your bulk or marketing messages while still receiving vital transactional messages.

(Optional) Webhooks

Lastly, you can set up webhooks to receive event information almost real-time. 

Click the Add New Webhook button, choose the Sending Stream, paste the webhook URL (your endpoint) into the designated field, select the events you want to listen to, and then test the setup. 

Mailtrap also allows you to batch up to 500 events within a webhook; that is - group all events under one object, and thus save on computing power. 

To read more about webhooks setup, events structure, and batching, check this article. 

Sending Domains 

After completing the setup process, you can always return to the Sending Domains tab to add any additional domains or subdomains. If you, for example, misspelled a domain, you’ll need to delete it and re-add it with the correct spelling. Note: You can’t create any additional demo domains, but you can delete the existing one if needed. 

Remember that the domain with the Demo badge can be used to send emails only to the email address you registered with. 

You can send emails to your recipients only from domains that have Verified status. If the status is Pending or Rejected, you won’t be able to send emails. 

From the Sending Domains menu, you can also delete the domains, subdomains, or the demo domain you no longer use. Just press the bin icon next to the domain. This will remove the domain from the list, and you won’t be able to send any further emails until you add and verify it again.

Note that removing a domain won’t remove it from your Mailtrap account completely. It will still appear, for example, in analytics, and will be displayed with the (deleted) suffix, just like in the example below:

We do this to preserve your historical stats that would otherwise be lost.