Overview

Email remains one of the most effective channels for direct and personalized communication, helping you build long-term customer relationships at scale. This guide walks you through every step required to configure and send emails with OneSignal—ensuring optimal deliverability and compliance from day one.

Email channel setup overview


Email setup

In your OneSignal dashboard, navigate to Settings > Email > Set up Email.

Activating Email platform in OneSignal settings

Select provider

Click Continue Setup to continue with OneSignal Email.

We also support external providers:

Email Setup Page

Create a sender

This step lets OneSignal send authenticated mail from your domain. Set your:

  • Default Sender Email: The default email address used to send messages when no other sender is specified.
  • Default Sender Name: The display name that appears in the recipient’s inbox (e.g. Acme Team, Maggie’s Newsletter).
  • Default Reply-To: The email address users will reply to. You can override this per email if needed.
  • Sending Domain: OneSignal will auto-generate a subdomain based on your Default Sender Email, which you can customize.

Default Sender Email

For optimal deliverability, use a subdomain (e.g., mail.yourdomain.com) rather than your root domain.

You can add more senders later in Senders Settings.

DNS configuration

You must configure DNS records to authenticate your sending domain. There are two options:

Use your domain registrar login to configure DNS automatically.

This method eliminates manual copying and ensures all required records are added correctly.

DNS Auto-Configure

Verify your account

Once DNS is set, click the “Verify” button to open a support ticket. You’ll be asked about your company and intended use cases.

Account Verification

  • Provide complete answers to speed up approval.
  • Our Support Team typically responds within 24 business hours.
  • You’ll receive an email when verification is complete.

You can send test emails while you wait!

While you wait, continue with email setup!


Email sending reputation

Maintaining a healthy email reputation is critical for deliverability.

Reputation is assigned by inbox providers and behaves like a credit score. Factors that influence it include:

  • Positive signals: opens, clicks, replies
  • Negative signals: bounces, spam complaints, spam traps

Keep bounce rate < 5% and complaint rate < 0.5%. Higher rates may violate our Acceptable Use Policy.


Understanding users and subscriptions

Each unique email address is treated as a separate email subscription in OneSignal.

Subscriptions can be created by:

  • Uploading email addresses via CSV
  • Using the API
  • Capturing email addresses with a web prompt
  • Using the SDK’s addEmail method

Important:

  • Email addresses are considered anonymous until you assign them an External ID.

Design emails

Design and personalize responsive emails using OneSignal’s editor or HTML.

Message personalization and localization

Customize messages using user data and language preferences.


Configure email behavior

Before launching campaigns, configure behavior settings:


Analytics and troubleshooting

Measure and optimize your email performance.


Congratulations! Your Email setup is complete.

Next steps:

  • Journeys: Build automated messaging flows
  • Tags: Add user-level data for targeting
  • Analytics: Track engagement and conversion metrics