# 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.

domain page

# 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.

create a domain

# Verifying domain names

Note: All domains must be verified by adding TXT and MX records to your domain's DNS configuration.

pending domain

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.

warning domain

dns records

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.



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.