Custom Domains

How to use custom domains with MailSlurp. Create email addresses with your own domain and send and receive email from tests, apps, or the web app.

Creating custom domains

MailSlurp supports sending and receiving emails from custom domains.

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

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 three records:

  • 1 TXT record to verify your domain
  • 2 MX records to handle inbound and outbound traffic

Once these are added the domain overview page will list your domain as verified. The verification is automatic but can take up to 72hours (usually it is much faster).

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 or via the API’s createInbox(emailAddress) endpoints. See the developer’s page for documentation.