# 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.
# Registering a domain name
You can use any 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.
# Verifying domain names
Note: All domains must be verified by adding TXT and MX records to your domain's DNS configuration.
Once you have created a domain you will need presented with a table of DNS records. You need to add these to your domain's DNS setup to verify the domain and to enable MailSlurp to send and receive emails on its behalf.
Each domain gets at least three records:
- atleast 1 TXT record to verify your domain
- atleast 2 MX records to handle inbound and outbound traffic
- additional DKIM records may be present
Once these are added the domain overview page will list your domain as verified. The verification is automatic but can take up to 72 hours (usually it is much faster).
# 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.
# 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.
