Email Quickstart

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.

Step 1. Setup Email Service Provider Support

Required unless setup for you by OneSignal.

Sending emails through OneSignal requires an account with an eligible email service provider listed below. If you do not have an account with a third party ESP already, get started quickly with OneSignal Email and ask about Email Onboarding.

Email ProvidersDetails
OneSignal Email SetupSupported
SendGrid SetupSupported
Mailgun SetupSupported
Mailchimp SetupSupported
Amazon SESNot Supported

Step 2. Add SDK Code

Optional but recommended if using the OneSignal SDK. Methods provided for creating new email records as they are provided to you. See Email SDK Methods to for a full list and example code.

Step 3. Email Web Prompt

Optional but recommended if you have a website and want to prompt users to provide their email. Use the Email & Phone Number Web Prompt to start gathering emails through a web prompt.

Step 4. Import Emails

Optional but recommended if you already have a list of email addresses and wish to immediately start sending emails, you can import them into OneSignal.

You can import emails through our Dashboard or server API. Details and code examples are available in Import Email Addresses guide.

Step 5. External User Ids

Required if using integrations.
Each email record in OneSignal gets a unique player_id (OneSignal's Device Id). The email player_id will be different from the push record player_id.

To map the unique email and push player_ids together under a single User Id, use the OneSignal setExternalUserId SDK method. See External User Ids. It is recommended to call this method after the email is set.

Step 6. Send Tags

Use Data Tags for custom user and event properties. These allow for message personalization and segmentation.

Common tags used for message personalization:

Tag KeyTag Value
real_nameuser’s full real name
first_nameuser’s first name
last_nameuser’s last name
user_namename that users give themselves; often not a real name (e.g. PokeCatcher22)
salutationif you wish to refer to users by a salutation (Ms, Dr, Hon, etc)

Step 7. Send Emails

You can send singular messages to test functionality and for ad hoc campaigns through our Dashboard
Or through API Email Creation

Set up automatic email and omni-channel sequences using Journeys.



You are a OneSignal Email Pro!