How to set up an inbound route

What is an inbound route?

Inbound email routing accepts and parses the contents and attachments any emails sent to an unique email address which is provided to you by MailerSend or any incoming email for a connected domain or subdomain and then sends the parsed results to your application's URL that you choose.

How does it work?

Once an inbound route has been added to one of your verified domains, all emails sent to that domain will be logged in the Inbound activity section of your inbound route page—and, if configured to do so, the email reply be forwarded to a specified email address or posted to an endpoint URL.

You can choose the dedicated email address provided by MailerSend or your own subdomain email address to receive and process incoming emails.

When to use an inbound route

You can set up an inbound route to allow your users to converse within your application or website.

For example: If your web app has a messaging feature where users can reply to comments or messages via email, you can set up an inbound route to post the reply to an endpoint of your web app. 

How to set up an inbound route

You can set up multiple inbound routes per domain in your MailerSend account. To set up an inbound route:

1. Navigate to the Domains page.

2. Select the domain for which you want to add an inbound route.

3. Scroll down to the Inbound route section and click Add an inbound route.

4. In the Name field, add a name for your inbound route. This is simply for internal reference purposes.

5. In the Inbound address field, you will find an inbound email address generated by MailerSend. You can use this default email address, or enter your own domain by enabling Inbound domain forwarding (optional).

If you are using the default inbound address generated by MailerSend, skip to step 7.

If you choose to enable Inbound domain forwarding, you can edit your custom subdomain by clicking Edit. You will then need to add an MX record to your DNS management platform with the value matching your custom inbound address.

To find instructions for adding the MX record to your DNS zone, or check if your custom inbound address has been accepted, click Check followed by Verify.

6. If you have Inbound domain forwarding enabled, you have the option to apply Catch filters to your inbound route.

These filters allow you to specify which inbound emails are accepted based on the email address recipients are sending to. You can choose from the following options:

  • Catch all - This option will not filter out any inbound emails sent to any email address on the account's inbound domain.

    For example: If your inbound domain is inbound.yourdomain.com, all inbound emails sent to any address using the domain @inbound.yourdomain.com will be detected, logged in MailerSend, and forwarded to any endpoint URLs/specified email addresses.

  • Catch recipient - This option allows you to exclusively capture replies sent to specific email addresses attached to the inbound domain.

    For example: If you select Catch recipient and enter the email address hello@inbound.yourdomain.com using the Equal filter, only emails sent to hello@inbound.yourdomain.com will be detected, logged in MailerSend and forwarded to any endpoint URLs/specified email addresses.

    You can apply up to 5 email addresses/filters under Catch recipient.

7. Now it’s time to Filter emails. The Filter emails step allows you to specify which inbound emails are accepted based on the email address recipients are sending from. You can choose from the following options:

  • Match all - All emails sent to the inbound route email address will be logged in MailerSend and forwarded to any endpoint URLs/specified email addresses.

  • Match Sender - This filter can be used to catch replies only from specific sender email addresses. For example, if you only want to see responses from the sender john@mailersend.com, this could be configured here. You can apply up to 5 filters.

  • Match domain - This can be applied if you only want to catch inbound emails from email addresses on specific domains, for example, mailersend.com. This can also be achieved using the Contains filter under Match sender. You can apply up to 5 filters.

  • Match header - The Match header option can be used if you only want to catch inbound emails that match specific email headers, for example, subject line. You can apply up to 5 filters.

8. Under Route to you can enter the endpoint URL or email address* to which you want to route inbound email messages. You can route to up to 5 destinations.

That’s it! Once you’re satisfied with your settings, click Save route to create your inbound route.

Where to find inbound emails

To find inbound emails:

1. Navigate to the Domains page.

2. Select the domain with the inbound route you wish to check.

3. Click on the inbound route you wish to monitor and scroll down to Inbound activity.

Under Inbound activity, you will first find the following 3 metrics:

  • Received - Displays the number of inbound emails that have been received but not yet processed

  • Forwarded - Displays the number of inbound emails that have been received and successfully processed

  • Errors - Displays the number of inbound emails that could not be processed due to an unforeseen error(s)

Note: Each successfully received inbound email is counted under Received once, if you are routing to multiple destinations (e.g an endpoint URL as well as an email address*) then the inbound email will be counted multiple times under Forwarded, once for each destination.

Below you will find a table containing all inbound activity, including the following information:

  • Event - Indicates whether the inbound email has been received, email forwarded, webhook forwarded, or contains an error

  • Sender - Displays the email address from which the inbound email was sent

  • Subject - Displays the inbound email subject line. Click the email subject to reveal the email header

  • Date - Displays the date and time the inbound email was sent

You can filter all incoming emails based on their activity or check all inbound emails sent to your inbound email address.

Inbound emails are free to receive, but are counted towards your monthly usage when forwarded or posted to your endpoint URL. One forward is equivalent to one sent email. So you have a combination of 4 endpoint URLs and forwarding addresses, it will count as 4 emails towards your monthly usage.

Need more info?

Feel free to reach out to support@mailersend.com. A member of our support team will gladly assist you.

*The ability to forward an inbound email to an email address will be available in the nearest future.