Skip to main content
Before you can receive emails on your domain, you need to enable receiving and add the required MX DNS records. This guide walks you through the process.

​
Prerequisites

  • A Nuntly account with a verified domain (or a domain in the verification process). See add a sending domain if you have not added one yet.
  • Access to the DNS settings of your domain.

​
Enable receiving on your domain

​
From the dashboard

1

Go to domains

In the dashboard, go to Domains and select the domain you want to enable receiving on.
2

Enable receiving

On the domain detail page, find the Capabilities section and toggle Receiving to enabled.

​
With the SDK

You can also enable receiving programmatically by updating the domain capabilities: 
import { Nuntly } from '@nuntly/sdk';

const nuntly = new Nuntly({
  apiKey: process.env.NUNTLY_API_KEY,
});

await nuntly.domains.update('your-domain-id', {
  receiving: true,
});

​
Configure MX records

After enabling receiving on your domain, you need to add MX records to your DNS configuration. These records tell mail servers to route incoming emails to Nuntly.
1

Find your MX records

On the domain detail page in the dashboard, the required MX records are displayed in the DNS records table. Copy the Name and Value fields.
2

Add records to your DNS provider

Add the MX records in your DNS provider’s control panel. The exact steps depend on your provider. Refer to their documentation for instructions.
3

Wait for DNS propagation

DNS changes can take anywhere from a few minutes to 48 hours to propagate. Nuntly automatically checks for propagation and updates the status on your domain page.
If you already configured DNS records when setting up your sending domain, you may only need to add the receiving MX record. Check the DNS records table on your domain detail page for the complete list.

​
Verify your setup

Once DNS has propagated and your domain shows a verified status, you can test receiving by sending an email to any address on your domain. By default, a catch-all inbox routes all incoming messages, so you do not need to create a specific inbox first. You can verify the email was received by:
  • Checking the Messages section in the dashboard
  • Calling the messages API to list recent messages
  • Listening for the message.received webhook event

​
Troubleshooting

MX records are configured but no emails are arriving Confirm that the MX record values match exactly what is shown in your Nuntly dashboard. Some DNS providers require you to remove trailing dots from record values. Also verify that the domain status shows as verified. Emails are arriving but marked as spam Nuntly runs automatic security checks on incoming messages. If a message fails the spam verdict, it is still stored but flagged. You can filter messages by spam verdict using the API. See messages for details.

​
Next steps

Create inboxes

Set up address-based routing for incoming emails

Receiving events

Subscribe to events when messages arrive