Email Setup

How to set up email messaging with OneSignal.

Email remains a powerful channel for reaching your users outside of your app or website. Every industry can leverage email's power to increase engagement, conversions, and retention. This guide will walk you through all the steps to have full email integration with OneSignal.

If you haven't already, sign up for a free account on onesignal.com.

If this is not your first app with OneSignal, click New App/Website. Otherwise, you will see the next page.

Name your app and organization something recognizable, then select Email from the platform list. You can set up more platforms later within the app's Settings page.

Click Next: Configure Your Platform.

OneSignal Email Configuration

The rest of this guide will follow the recommended OneSignal Email Setup but if you have a SendGrid, Mailgun, or Mailchimp account already, you can integrate those into OneSignal following these guides:

Select OneSignal and Continue.

Set Sending Domain

Input your sending domain name, then click Save & Continue.

This is a domain you own and have access to the DNS records. If you are unsure, check with your domain administrator. We recommend using a subdomain. For example, if your root domain is onesignal.com a good subdomain to send emails from is mail.onesignal.com.

📘

Don't have a Sending Domain?

See our Email Sending Domain Setup Guide for a step-by-step walkthrough on how to purchase and setup your sending domain with Cloudflare.

Add DNS Records

Select Auto Configure to automatically set up your DNS records.

Auto Configure DNS Authentication

Auto Configure DNS Authentication

Alternativley, you can manually add the DNS records. For instructions, please see the DNS Configuration Steps.

Manually DNS Records Authentication

Manually DNS Records Authentication

Add Default From and Reply-To Emails

Set a default From Name and From Email to show your brand. If you want users to reply back to emails, you can set a default Reply-To Email. These can always be changed later and at a per-message basis.

Import Emails

If you have a list of emails ready, select Upload CSV or add your own email to test with Add Email. If you have a website setup, you can also Add Web Prompt. These can always be added later.

Verify Your Account

You are almost done! You just need to click verify your account at the top of your OneSignal app. This will open a support ticket and ask you some questions about your company and use cases.

Be as detailed as possible with your answers. Our Support Team will review and follow up ASAP!

You can leave the chat and you get an email from us when ready. It may take up to 24 business hours.

Send Test Emails

While you wait for your account to be verified, you can send test emails from Messages > Email > New Email > .

Go to step 3.Message Select the Drag & Drop or one of the Editors.

Add a Subject, and any content to your message and click Send Test Email.

Input your email and press Send Test Email. An email should arrive to your inbox shortly!

🚧

Check your Spam Folder

While your account is being verified, you can still send test emails. But if your domain is not Authenticated yet, we'll send your test emails from a different sending domain. We do our best to ensure deliverability on our shared sending domain, but sometimes messages will end up in the Spam folder.

If you don't see any test email, make sure you account for DMARC settings on the domain you're authenticating, try updating your From address to a personal email address and test again.

Once your custom sending domain is Authenticated, you'll see the test emails send from your sending domain.

👍

Setup Complete!

As you start sending emails, its highly encouraged to follow a Warm-Up Plan to build your domain reputation, increase deliverability and make sure you don’t get listed as spam.

Return to the Onboarding With OneSignal for next steps.

If you have any questions, feel free to drop us a line!

Email us at [email protected]


What’s Next