Use this guide to identify and resolve the most common OneSignal email issues, including setup problems, deliverability challenges, and design errors.
Before troubleshooting, review our Email Setup and Email Deliverability guides. These cover the most common causes of email issues.

Setup issues

Most setup problems come from incorrect DNS records or limitations from your Email Service Provider (ESP).

Verify DNS records

  1. Open your DNS provider.
  2. Confirm that SPF, DKIM, and MX records match our Email DNS Configuration guide.
  3. Allow up to 24 hours for DNS changes to propagate.
If DNS records are misconfigured, emails may fail to send, bounce, or be marked as spam.

Monthly send limits (non-OneSignal ESPs)

If you use SendGrid, Mailchimp, or Mailgun directly (not via OneSignal Email), your sending volume is limited by your ESP plan.
Check your provider’s logs:

Too many DNS lookups

When testing SPF records with tools like URI test, you may see:
Too many DNS lookups

Too many DNS lookups

This is expected if you use the SPF record:
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
OneSignal uses Mailgun “under the hood” as our Email Service Provider. This means the SPF lookups point to the same IP ranges and doesn’t actually add any additional lookups. To remove the warning, you can simplify to:
v=spf1 include:mailgun.org ~all
This will prevent the error and not impact OneSignal email sending.

Multiple TXT records for sender domain

You can only have one SPF record for your sending domain.
Check with WhatsMyDNS TXT lookup to confirm you do not have multiple entries.

Deliverability issues

Deliverability problems include slow sends, spam folder placement, and email bounces.

Delayed emails

If your sending domain is new or has low reputation, ISPs (Gmail, Outlook, Yahoo) may delay delivery. This is called rate limiting or greylisting. When looking at your Email Message Reports, you can check the details of how long it took us to send the message.
Email message report

Email sent from OneSignal in less than 3 seconds

In this example, we see the email was sent from OneSignal in under 3 seconds. We send it to the Email Service Provider, which then goes to the recipient’s ISP. These email servers may delay the email up to several hours before it gets delivered to the recipient.
Follow our Email Reputation Best Practices to speed up delivery.

Emails landing in spam

The most common cause is poor sender reputation. Follow our Email Deliverability guide. If you are using a third-party ESP, see:

Sending & receiving from the same domain

A single domain cannot use the same MX records for sending and receiving mail simultaneously. If you want to send from @yourdomain.com and also receive on the same domain:

Suppression lists

If an address unsubscribed or marked you as spam, your ESP will suppress sends to it.
To resubscribe:
  1. Go to Audience > Subscriptions in OneSignal.
  2. Search for the email address.
  3. Click Unsubscribe from Email (if subscribed) then Resubscribe to Email.
  4. Send a test email to confirm.

Apple Private Relay

If you send to @privaterelay.appleid.com addresses, you must verify your sending domain in your Apple Developer account.
Unverified domains will result in dropped emails.

API key too restrictive

If using SendGrid or Mailchimp, ensure your API key has the minimum required permissions.

Email design

These are problems inside the email content itself. Usually caused by missing or incorrect CNAME configuration.
If using a third-party ESP, follow their tracking domain setup.

Buttons not clickable

  • Ensure the URL is correct and starts with https://.
  • Avoid testing from your spam folder—some email clients block links there.

Adding images to preheader

Gmail supports promotional images in preheaders (deal annotations, product carousels).
See Gmail Developer Portal for setup.

Email Service Providers (ESPs)

Common questions or issues related to using our integrations with SendGrid, Mailchimp, or Mailgun.

Do I have to pay another provider for email?

If you use the OneSignal Email Setup then we 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.

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.