Skip to main content
OneSignal Email lets you send marketing and transactional emails from the dashboard, Journeys, or the API.
  • Send marketing campaigns and transactional messages from the dashboard or API
  • Build automated email and multi-channel flows with Journeys
  • Design emails using drag-and-drop or HTML
  • Personalize content with dynamic fields, conditional logic, and language variants
  • Track performance and A/B test with detailed analytics
  • Segment your audience for precise targeting
  • Integrate with CRMs and tools like HubSpot, Mixpanel, Amplitude, Zapier, and more

​
Email setup

Before sending emails, follow these setup guides:
Authenticate your domain (SPF, DKIM, DMARC) and enable Auto warm-up before sending at scale to protect your sender reputation and inbox placement.

Email setup guide

Verify your sending domain and enable email in OneSignal.

DNS configuration

Automatically configure DNS with one click or complete setup manually.

Senders

Manage from names, from addresses, reply-to addresses, and multiple sending domains.

BCC emails

Send hidden copies of outgoing emails for archiving, compliance, or third-party integrations.

Email template forwarding

Import existing email templates by forwarding them directly to OneSignal.

Transactional email setup

Trigger emails based on user actions or custom events.

Custom unsubscribe pages

Replace the default unsubscribe page using OneSignal APIs.

​
Deliverability, reputation, and analytics

Deliverability determines whether your emails reach the inbox or land in spam. OneSignal provides tools and guidance to help you build and maintain a healthy sending reputation.

Email deliverability

Understand how inbox placement works and how OneSignal supports it.

Email reputation best practices

Warm domains, manage volume, and avoid spam filters.

Auto warm-up

Automatically ramp sending volume for new domains.

Google Postmaster Tools

Monitor Gmail reputation and delivery signals.

Suppressions

Manage blocked and suppressed email addresses.

Email message reports

Track open, click, and conversion rates.

Email troubleshooting

Diagnose and resolve common delivery issues.

Create a confirmed opt-in journey

Use Tags, Segments, and Journeys to create a confirmed opt-in journey.

Add your own verification links

Learn how to add your own verification links to your emails.

​
Design your emails

OneSignal supports visual and code-based email creation. Use the drag-and-drop editor for quick campaigns or the HTML editor for full design control. You can also start from a template and customize from there.

Drag-and-drop editor

Build emails visually without writing code.

HTML editor

Design fully custom emails using HTML.

Templates

Start from pre-built templates or create and save your own layouts.

Unsubscribe links and headers

Control unsubscribe behavior, headers, and compliance settings.

Message personalization

Personalize content using user data and conditional logic.

Multi-language messaging

Send localized emails in multiple languages.

Email template forwarding

Import existing email templates by forwarding them directly to OneSignal.

Copy template to another app API

Move templates between OneSignal apps.

​
Send emails

Send messages from the dashboard, automate them with Journeys, or trigger them programmatically via the API.

Dashboard

Compose a message quickly within the dashboard.

Send via API

Send messages programmatically using the REST API.

Journeys

Build automated, multi-step, and multi-channel flows.

A/B testing

Test up to 10 message variants to optimize performance.

​
Send from the dashboard

Select the message channel

Select Create… then choose your message channel. You can also navigate to Messages or Templates to view previous messages.
OneSignal dashboard showing create message options

Create a new message in the OneSignal dashboard.

Choose a composition method

Set a name and label

Add internal metadata for tracking and reporting. API equivalent: name

Select your audience

Choose which users receive the message. You can include and exclude segments to target specific groups. Defaults to all “Subscribed Users” if no segment is set.
Dashboard fields for message name, label, and audience segment selection

Name, label, and audience segment selection in the dashboard.

​
Sender

Configure the sender details used for this email:
  • From name
  • From address
  • Reply-to address
  • Sending domain
Multi-domain sending is supported. See Senders.
API fields: email_from_address, email_sender_domain, email_reply_to_address

​
Subject and preheader

Set a required subject line and optional preheader text. Preheader display varies by inbox provider; not all inboxes show it.

​
Tracking and compliance

Link tracking: Enabled by default. Supports multi-link tracking. See Links and Deep linking for details.
  • API field: disable_email_click_tracking
Send to unsubscribed users: Enable only for compliance or non-marketing messages.
  • API field: include_unsubscribed
Email composition panel showing link tracking and unsubscribe send options

Tracking and compliance options when composing an email.

​
Delivery schedule and optimization

Choose when the message should start sending.
The “start sending” time determines the audience cutoff. OneSignal evaluates segment membership at that moment; anyone in the audience receives the message, regardless of per-user optimization settings.
Per-user optimization: Set when users should receive the message.
With Intelligent Delivery or Custom time per timezone, delivery spans a 24 hour period so every record in the audience can receive the message. If it is already 10am for a recipient when a 9am-local message sends, they receive it at 9am the following day.
Click Review and Send to send immediately or on schedule, or Save as draft to edit later. Once sending begins, monitor performance under Messages > Email or in Messages > All messages. See Email message reports for details.

​
Analytics

Track message performance and engagement.

Email message reports

Message-level delivery, open rate, and click-through reporting.

Analytics overview

All analytics options available in OneSignal.

Event Streams

Stream push events to your data warehouse or BI tools in real time.

View messages API

Pull message analytics programmatically via the REST API.

​
FAQ

​
What’s the difference between marketing and transactional emails?

Marketing emails are campaigns sent to a segment of users, such as promotions or newsletters. Transactional emails are triggered by a user action or event, such as a password reset or order confirmation. See Transactional email setup for configuration details.

​
Why are my emails going to spam?

Common causes include missing DNS authentication (SPF, DKIM, DMARC), sending to unengaged users, or ramping volume too quickly on a new domain. See Email deliverability and Email reputation best practices for guidance.

​
Can I send emails to users who unsubscribed?

Only for compliance or non-marketing messages, such as legal notices. Enable the Send to unsubscribed users option when composing or set include_unsubscribed via the API. Using this for marketing emails violates anti-spam regulations.

​
How do I test emails before sending to Users?

Set up Test Users to verify delivery, rendering, and deep links without affecting real Users. You can also send to a single-user segment for quick testing.