OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Email Overview

Overview of OneSignal Email Messaging

OneSignal supports email as a messaging channel to provide you with more ways to reach users.

Why use OneSignal for Email?

Marketing Emails - OneSignal provides an easy-to-use email building interface that lets you construct fantastic templates for all your emails. You won't have to worry about writing your own email templates and worrying about how they look in different email clients, nor will you have to pay for an expensive email marketing solution for all your users.

Transactional Emails - Leverage OneSignal's powerful server-side API to target emails directly when purchases are made or events occur that need a direct email.

Automated Emails - OneSignal's Automated Messages allows you to send emails to devices with no code required.

Segmentation - Implementing the OneSignal SDK in your app or website allows user information to be available for segmentation and personalization. For example, when a user last opened your app/website, how many times they've visited your app/website, or any custom data you send.

Single SDK- You won't need to manage separate SDKs for email and push, and you'll be able to use the same familiar methods and syntax that you already use for push.

Single API - You can use the same APIs, segments, and other features that you may use for push notifications to send your emails as well.

Analytics - All your analytics are in one place, for both your transactional messages and marketing messages you send from the OneSignal dashboard.

OneSignal Email Messaging sits atop your existing email service provider (ESP), adding the above marketing functionality. Essentially, you get to send marketing emails at transactional email prices.

Most mobile applications don't use email well, if at all. OneSignal makes it easy to synchronize emails from a mobile app to our database. We also make it easy to send us custom tags and other personalization data. OneSignal is way easier to use for mobile applications than other options on the market.



Sending Emails

Send emails using OneSignal's:


Create reusable email templates that can be sent and updated easily through all our messaging options.

Delivery Statistics

Limited depending on the supported Email Service Provider.

Email Service Provider Support

OneSignal Email Messaging requires an account with an eligible email service provider.

Email Providers








Amazon SES

Coming soon


Contact us

New Concepts in Email Messaging

Email introduces a few new concepts to OneSignal that are worth reviewing.

Identity Verification

See Identity Verification

Merge Tags

Emails support the same Message Personalization capabilities supported in push notifications, meaning you can personalize your emails, e.g.:

Hi {{first_name | default: there }}, you're invited to an exclusive group!


Email handles subscriptions a bit differently than push notifications. Users may unsubscribe themselves from emails, as well as mark emails as spam. These may show up in Message Reports. You may also unsubscribe users manually, see How does Unsubscribing Work.


Get Started

Just click here to get started.

Updated 2 months ago

What's Next

Email Quickstart

Email Overview

Overview of OneSignal Email Messaging

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.