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:
- Select OneSignal as your provider during email setup
- Complete the setup form
- Someone from our team will set up your IP address and contact you to update your domain DNS settings
- 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.
- 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 os.tc subdomain (e.g., [email protected])
- 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.
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., mail.your-company.com) or we can provide you an
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.
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.
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.
The number of email addresses you plan to upload.
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.
Please be sure to review our policy, which states our requirements for proper use of OneSignal email.
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.
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.
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.
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.
In OneSignal > Messages > Email, select New Email.
Subject and click Send Test Email. Input your email and press Send Test Message.
If running into issues, see our Email FAQ.
When contacting support, for faster assistance, provide:
- Your OneSignal App Id
- Details, logs, and/or screenshots of the issue
- Steps to reproduce
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.
Emails can be added into OneSignal using the following options outlined in our Import Email Addresses guide.
Programmatically add emails server side.
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.
Visit Email Tutorials for next steps.
By using OneSignal email, you agree to our Acceptable Use Policy and Terms of Service.
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
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.
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.
Visit the Email FAQs page for information on how to find each record for some of the most popular domain providers.
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!):
Updated 19 days ago