Setup a Custom Sender Domain

How to Use Your Own Sending Domain with OneSignal Email


This guide is only for OneSignal email.

If you are sending through Mailgun, Mailchimp, or Sendgrid, take a look at the Email Troubleshooting to learn more about domain setup for those ESPs.

When you first set up OneSignal email, we recommend sending emails through the provided OneSignal domain. This will help you get sending sooner without having to update your DNS settings.

When you're ready to start sending emails using your own domain, follow the guide below.

OneSignal Email First-Time Setup

If you haven't already set up OneSignal email, follow the OneSignal Email Guide and choose the "Yes, I'll configure my own domain" option.


Selecting a radio option to allow a custom domain to be used for sending domain when setting up OneSignal email.

Provide a point of contact of the person who will configure the DNS settings so we can reach out to them. We'll send them the records that need to be updated (two TXT (SPF and DKIM), two MX, and a CNAME record).


Specifying a contact email address when requesting a custom domain for OneSignal email.

Bringing Your Own Domain After Setup

If you've already set up OneSignal email and want to use your own domain instead of the one that we've provided, go to Settings > Platforms > Email. Select OneSignal and Continue.

On the next screen, click the Contact our Support team link to start a conversation with a member of our team. Please provide them with the domain name you wish to use.

Step 1. Check your inbox

We will send you an email within two business days with the DNS records that need to be updated.

Step 2. Update your DNS settings

Go into your Domain Registrar, and add the TXT, MX, and CNAME records provide to you. Visit the Email FAQs page for information on how to find each record for some of the most popular domain providers.

Step 3. Confirm changes

Let us know that you've correctly updated your DNS settings by replying to the email or contacting Support. Once you have confirmed the changes to your DNS settings are complete, we will finish the configuration on our end, and you can start sending.

Step 4. Start sending

Create a new campaign and start sending!


New domain? Consider throttling sending to warm your domain

If you are sending from a new sending domain or subdomain, you may want to consider warming the domain to improve deliverability. Follow the Email Warm-Up guide to learn more.