MailSlurp supports unlimited custom domains. Buy your domain then add it to the MailSlurp dashboard. DNS records will be generated and assigned to your account. Add these to your domain provider DNS settings to verify and enable custom email addresses.
We recommend following the more detailed step by step domain creation guide for more information.
Custom domains allow you to use any email address you wish under that domain. In order to use custom domains you need to verify the domain in the MailSlurp dashboard.
Registering a domain name
To use custom domains with MailSlurp you must own or have access to a domain name and DNS server settings. You can use any Domain Name Provider to purchase a domain name.
See the extended domain guide for examples.
MailSlurp domain settings
Once you own a domain you can configure MailSlurp to use it. Go to the domains page to see a list of your current domains. Click the
button to create a new domain.
Domains can be either
type domains. This determines the type of inbox you can create with the domain.
inboxes are processed by AWS SES while
inboxes use a custom mail server running
inboxes are best for most cases.
inboxes are more suited for public facing email addresses that support older email clients but are receive-only and cannot send.
records that reference AWS servers.
domains use an
Adding a domain to MailSlurp
On the create domain page you can enter a domain name.
This should be a top level domain with no
can be used with MailSlurp to create inboxes with addresses such as
You can send from any subdomain of that domain without specifically verifying the subdomain.
For example, if you verify
, you do not need to verify
Verifying domain names
Note: All domains must be verified by adding TXT and MX records to your domain's DNS configuration.
You can view your domain records in the dashboard domain view page. An email containing the records with also be sent to your account.
You need to add these DNS records (MX, C, TXT)to your domain's DNS setup to verify the domain and to enable MailSlurp to send and receive emails on the domain's behalf.
DNS record entry:
Note each account is given unique records. Login into your account to view domain records. Create a domain to view the records.
record is generated for your domain and must be added to your domain DNS settings to allow verification.
It takes the format:
You must add a single
to your domain provider to allow MailSlurp to receive emails on behalf of your domain.
There are two possible MX records depending on the type of domain you create.
domains can be used with
inboxes are processed by a mail server running at
inboxes are handled by AWS SES. Use
for public facing inboxes and
for internal or test email accounts. For more information see the SMTP vs HTTP inbox guide.
An HTTP domain has a static MX record pointing to AWS SES servers.
An SMTP domain has an MX record that points to the MailSlurp mail server.
Prior versions of MailSlurp included additional MX records. Do not include the following bad records as they may result in 530 errors:
Note on priority
MX priority is indicated by the
in the record value. In some hosting settings the priority should be entered into a separate field. In most providers it is included in the field directly as shown above.
The SPF value is a way to increase the sender reputation of your domain, mail delivery, and prevent spoofing. It has a static value of
Test DNS Records
It is useful to test the DNS records you have added to your domain. Use the Domain Tester widget to fetch the DNS records for your domain. Make sure your records include those required by MailSlurp.
Check inside the app dashboard to view the status of your domain. If your domain is not verified after 24 hours double check your DNS records using the Domain Tester or by checking your DNS settings in your domain provider. If 72 hours passes we recommend deleting the domain and restarting the process.
Debugging common errors
See the following related articles
Creating email addresses
Send and receive emails from custom domains
Receiving emails with custom domains
There are many ways to receive emails with a custom domain using MailSlurp. You can view emails in the dashboard or by using the API
REST API clients
Webhooks allow HTTP push of emails to your server when received by a custom domain inbox. Create an inbox webhook using the API or dashboard. See the email webhook guides for more information.