# Creating custom domains
MailSlurp supports sending and receiving emails from custom domains. 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 (opens new window) Domain Name Provider to purchase a domain name.
# MailSlurp domain settings
Once you own a domain you can configure MailSlurp to use it. Go to the domains page (opens new window) to see a list of your current domains. Click the + button to create a new domain.
# Adding a domain to MailSlurp
On the create domain page (opens new window) you can enter a domain name.
This should be a top level domain with no @ symbols.
For instance mycompany.com can be used with MailSlurp to create inboxes with addresses such as contact@mycompany.com.
TIP
You can send from any subdomain of that domain without specifically verifying the subdomain.
For example, if you verify example.com, you do not need to verify a.example.com or a.b.example.com.
# 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.
# Record Types
TIP
Note each account is given unique records. Login into your account to view domain records (opens new window). Create a domain to view the records.
# Verification record
A TXT record is generated for your domain and must be added to your domain DNS settings to allow verification.
It takes the format:
recordType = TXT, name = "_amazonses.${domain.domain}", recordEntries = listOf(domain.verificationToken), ttl = 60
- Name:
_amazonses.<your-domain> - Type:
TXT - Records:
<your-verification-token> - TTL:
600
# MX Record
You must add a single MX to your domain provider to allow MailSlurp to receive emails on behalf of your domain.
It has the static value:
- Name:
<your-domain> - Type:
MX - Records:
10 inbound-smtp.us-west-2.amazonaws.com - TTL:
600
WARNING
Prior versions of MailSlurp included additional MX records. Do not include the following bad records as they may result in 530 errors:
10 inbound-smtp.us-west-2.amazonses.com10 email-smtp.us-west-2.amazonaws.com
# Note on priority
MX priority is indicated by the 10 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.
# SPF record
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 v=spf1 include:amazonses.com -all
- Name:
<your-domain> - Type:
TXT - Records:
v=spf1 include:amazonses.com -all - TTL:
600
# DKIM records
DKIM tokens allow you to verify a domain and prevent spam ratings. The DKIM token for you domain is displayed in the dashboard (opens new window). DKIM records take the following format:
- Name:
<dkimToken>._domainkey.<your-domain> - Type:
C - Records:
<dkimToken>.dkim.amazonses.com - TTL:
600
# 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.
TIP
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
Once you have created and registered a domain you can create any email address you like using the Dashboard's create inbox page (opens new window) or via the API's createInbox(emailAddress) endpoints. See the developer's page for documentation.
# Send and receive emails from custom domains
In code or the dashboard create inboxes using your custom domain.
