Email FAQ & Troubleshooting

Using Email with OneSignal FAQ

Common Troubleshooting

Troubleshooting Guides

What DNS records do I need for setup?

  • TXT records (known as SPF & DKIM) are required to send and receive email.
  • MX records are recommended for all domains, even if you are only sending messages.
  • The CNAME record is necessary for tracking opens, clicks, and unsubscribes.

Can I use the same domain for multiple Email Service Providers?

You can use the same domain for sending email from multiple ESPs but you can only use one email server to receive messages for a given domain name.
If you want to use multiple ESPs for the same domain, then the MX records should be removed from one of your ESPs.
However, without these MX records in place, you might see an increase in "Sender Domain Verification" errors, which are errors that the recipient server returns whenever your domain lacks MX records. You should configuring your domain with MX records (either with OneSignal or an alternate incoming server) so the "Sender Domain Verification" error gets a solution, and is prevented from occurring in future cases.

To merge multiple SPF records, an example would be: v=spf1 ~all

Why are URLs in my email design not working?

This usually happens if your CNAME record is not setup correctly. However, your ESP may have other configurations that need to be setup. Mailgun has a good guide on this here:

Why are buttons in my email design not clickable?

Make sure that your button has a URL specified for it in your email's design. Also, ensure that you're not viewing the email from inside your email client's Spam folder, as the email client may block all link clicks automatically.

What can I do if I am being marked as spam?

Generally, being marked as spam happens when your domain name is put on a deny list from an ISP, and therefore all emails passing through that ISP are marked as spam.

Make sure you follow the Email Best Practices guide to reduce spam reports.

You will also want to work with your Email Service Provider to figure out which deny list you are on, and then work with the specific ISPs to get removed from their lists.

Here are some helpful policies and procedures from our supported ESPs:

Using Email

Does OneSignal Email Messaging work with all email clients?

Generally yes - a lot of work has been put into ensuring maximum compatibility and visual similarity across major email clients including Gmail, Outlook, yahoo mail, and more.

How do I add images to my pre-header?

Gmail allows for images in the pre-header aka Deal Annotations and Product Carousels within the Promotions tab. Details can be found on Google's Gmail Developer Portal.

How does unsubscribing work?

See our Unsubscribe Links & Email Subscriptions guide for more details.

How can I resubscribe emails?

See our Unsubscribe Links & Email Subscriptions guide for more details.

Can I send emails to my push notification subscribers?

Yes, but email addresses are not automatically collected when users subscribe to push notifications. You must set the email address within OneSignal before you can send the user an email.

If your app or website collects email addresses, you can use the setEmail method to add an email address into OneSignal.

If your app or website does not collect email addresses, you will need to do so in order to send emails to your push subscribers. See Importing Email Addresses for all options on getting emails into OneSignal.

Can I target emails based on lists or campaigns?

Yes. If you have email lists in CSV format, you can import the lists into OneSignal.

After importing, you'll be able to add Data Tags and create groups of subscribers called Segments, allowing you to send targeted and personalized email messages and campaigns.

Can I use affiliate links in emails?

OneSignal's email delivery is sent through a 3rd party provider such as Mailgun, Mandrill, or Sendgrid. So, both we and you are bound by any policies and limitations of those services.

Here are some helpful articles or policies from our supported ESPs. We recommend reaching out to their support teams if you have a question about their policies for including affiliate links in your emails.

Email Limits - Is there a limit?

Apps on a Free Plan have a monthly limit of 5,000 email sends. This limit resets at the beginning of each calendar month.

Apps on a Paid Plan have a monthly limit of 500,000 email sends. This limit resets based on your accountโ€™s specific billing cycle. If you plan to send at higher volumes, please contact Support to ensure no disruption to your service.

Any email campaigns that would put you over your email will not be sent.

What is OneSignal's Email Throughput?

OneSignal generally sends messages at a rate of 1,000 to 5,000 per second to the Email Service Provider. It is up to your ESP to deliver the emails to your users.

OneSignal uses Mailgun for OneSignal Email and Mailgun advertises that they can support up to 15 million emails per hour.

Email Service Providers (ESPs)

Which email service providers are supported by OneSignal?

Currently, Sendgrid, Mailgun, and Mailchimp are supported by OneSignal.

Do I have to pay another provider for email?

If you use the OneSignal Email Setup then OneSignal will manage your email accounts and you do not need to use another email provider.

If you plan to use Sendgrid, Mailchimp, or Mailgun, then you will need to continue to pay your email service provider directly.

Since OneSignal provides both marketing and transactional email capabilities along with user management, segmentation and automation tools, you only need to pay these ESPs the much cheaper transactional email rates, rather than the higher rates typically charged for marketing automation tools.

What are Webhooks? Why does OneSignal require them?

Webhooks are a method for connecting two separate apps and allowing them to share data with each other, and are often used for things like analytics integrations. They are sent from your email service provider to OneSignal to sync email delivery statistics with our platform.

For troubleshooting webhooks with the ESPs we support, see our related FAQ for Webhooks & Why Email Stats Not Detected?.

How do I set up OneSignal if I already have an active Webhook?

You can continue to use your custom/existing webhook, but you'll need to follow the steps in FAQ for Existing Webhooks for how to forward the request to OneSignal's Webhook URLs.

How do I configure my domain for sending email through OneSignal?

To configure your domain for email, you will need to modify your domain's DNS records with your domain provider according to the directions provided by your ESP. Different email service providers have different requirements for which records need modifying, which likely include MX, CNAME, and TXT record types.


DNS record changes may take up to 48 hours for changes to propagate across the Internet.

Below are links to how-to guides for some of the most popular domain providers. Please note that these guides are written by the domain providers and are not maintained by OneSignal.

Domain ProviderDocumentation Links
NamecheapDNS Questions
Network SolutionsHow do I manage DNS and advanced DNS records?
RackspaceMX, CNAME
HostGatorMX, CNAME
CloudflareManage DNS Records
DreamhostAdding custom DNS records
Dyn (Oracle DNS)Set up DNS
HoverManaging DNS records
Amazon Route 53Working with records