OneSignal Email Setup

Send Emails with OneSignal instead of bringing a third-party ESP

OneSignal email is a quick and easy way to get started sending emails. Sending emails with OneSignal instead of bringing your own email service provider (ESP) reduces the number of platforms your business needs to use and make payments to.

Setup is simple:

  1. Select OneSignal as your provider during email setup
  2. Complete the setup form
  3. Someone from our team will set up your IP address and contact you to update your domain DNS settings
  4. Start sending ๐ŸŽ‰

The setup process can take ~2 days or longer, but ultimately depends on how quickly we receive replies from you. It takes longer to setup email on OneSignal compared to other channels because of the DNS configuration, which requires giving OneSignal permission to send emails on your behalf.

Step 1. Requirements

  • Make sure you are on a paid OneSignal Account (growth, pro, or enterprise)
  • If you have a subdomain you would like to use, please ensure you have access to the domain provider to update DNS records
  • Optional: If you do not have a subdomain, we can provide you a custom subdomain (e.g., [email protected])

Step 2. Enable Email Messaging

  • In OneSignal, navigate to Messages > Email if you are setting email up for the first time. Otherwise, you can always update email settings by going to Settings > Platforms > Email.
  • Select OneSignal and Continue.

Image of OneSignal email as an email provider option.

Step 3. Complete the OneSignal Email Setup Form


Image of OneSignal Email Setup Form


Provide an the email address that you want our support team to use to contact you during the setup process.


You can bring your own subdomain (e.g., or we can provide you an domain.

If you decide to use your own subdomain, please ensure the contact person has access to the DNS records and can communicate with the support team in a timely manner. The more quickly we receive responses and are able to verify information with you, the sooner setup will be completed.

You will be given two TXT (SPF and DKIM), two MX, and a CNAME record. Update these records in your DNS provider. It may take up to 48 hours (usually less) to propagate. Please let our support team know once the records are verified so that our team can proceed with setup.

If you would like us to provide a custom subdomain, please indicate the desired subdomain in this format: โ€œcompany-name.os.tcโ€. If you decide that you would like to change this after you've submitted the form, please reach out to our support team to do so.

Email Validation

Itโ€™s a good idea to validate email lists before sending emails to a segment. This ensures that email addresses are real, spelled correctly, and wonโ€™t result in a bounce. It helps improve your deliverability.

User Consent

You are responsible for ensuring that the recipients of your emails have consented to receive that email. How you collect and manage your marketing subscriptions and consent is up to you.

Estimated Email Contacts Volume

The number of email addresses you plan to upload.

Expected Send Volume

A monthly estimate of your expected number of email sends. Charges are based on usage (number of emails sent). For those planning to send 500k emails a month or more, please reach out to a sales representative.

Acceptable Use Policy

Please be sure to review our policy, which states our requirements for proper use of OneSignal email.

Step 4. Configure delivery defaults

In OneSignal, add the default name and email address you want your emails to come from (these can be changed later).

Press Done when finished.


Image of email configuration options to set a default "From: name" and "From: email".

Step 5. Add subscribers

If you have a list of emails ready, select Upload CSV to Import Email Addresses. You can always do this again later.

If you have a website and want to prompt users to provide their email. Select Add Web Prompt to use OneSignal's Email Web Prompt.


Image of email import page with option to upload CSV or add a web prompt to collect emails.

Step 6. Wait for an email from a OneSignal support team member

We will contact you when your email has been set up and is ready to send from, along with additional information and steps, if applicable.

Step 7. (Optional) If using your own subdomain, confirm DNS records

Our support team will contact you and provide you DNS information so that you can update your domain provider. After 48 hours (sometimes less), the records will update and be verified. Please let our team know so that we can proceed to setup your OneSignal email.


Confirm all DNS records are verified.

Please see our Email FAQ for more details.

Step 8. Send yourself a test email


Image of email editor.

In OneSignal > Messages > Email, select New Email.

Add a Subject and click Send Test Email. Input your email and press Send Test Message.



If running into issues, see our Email FAQ.

If stuck, contact support directly or email [email protected] for help.

When contacting support, for faster assistance, provide:

  • Your OneSignal App Id
  • Details, logs, and/or screenshots of the issue
  • Steps to reproduce

Step 9. Set Custom User Properties

OneSignal creates channel-level device records under a unique Id called the player_id. A single user can have multiple player_id records based on how many devices, email addresses, and phone numbers they use to interact with your app.

If your app has its own login system to track users, call setExternalUserId at any time to link all channels to a single user. For more details, see External User Ids.

All other event and user properties can be set using Data Tags. Setting this data is required for more complex segmentation and message personalization.

Step 10. Collect New Emails

Emails can be added into OneSignal using the following options outlined in our Import Email Addresses guide.



Dashboard Upload

Upload a csv of emails and user data or manually add emails.

Server API

Programmatically add emails server side.

SDK setEmail method

Add emails using our client side SDK. Recommended if using our SDKs for push or in-app messaging.

Email Web Prompt

A web prompt that allows user to include their own email address and phone number.


Setup Complete!

Visit Email Tutorials for next steps.

By using OneSignal email, you agree to our Acceptable Use Policy and Terms of Service.


How does OneSignal email ensure deliverability?

OneSignal's uptime hovers around 99.8 and our systems statuses and updates can be found here. We carefully maintain our sending reputation to keep deliverability high.

users reputation defines their deliverability. their usage of their app defines the deliverability

What are the expectations of acceptable use?

We expect OneSignal email users to retain a good sender reputation. We closely monitor to ensure our users are using email properly and have:

  • Bounce Rate < or equal to 0.5%
  • Unsubscribe Rate < or equal to 1.5%
  • Spam Complaint Rate < or equal to 0.08%

Any violations may affect your long-term deliverability success. Please read our acceptable use policy for more details.

How do I get my own subdomain?

The steps to set up your own email subdomain can vary between email service providers (ESPs). Please refer to your domain provider for specific instructions.

How do I configure my DNS records?

Visit the Email FAQs page for information on how to find each record for some of the most popular domain providers.

How do I whitelist OneSignal's IPs?

OneSignal uses GCP data centers located in Groningen, Netherlands. There are a wide range of IPs that can be used. You can copy-paste the following IP ranges to your whitelist (make sure to include your own IP Address if you have not!):,,,,,,,,,,,,2600:1900:4060::/44

Did this page help you?