Skip to main content
OneSignal Email helps you send targeted, personalized, and high-converting marketing and transactional emails at scale. Whether you’re onboarding users, re-engaging inactive customers, or driving sales, OneSignal provides everything you need — from design and automation to deliverability and analytics. This page gives you a complete overview of what’s possible with OneSignal Email and links to detailed guides to help you get started. What you can do with OneSignal Email:
  • Send marketing campaigns and transactional messages through the OneSignal Dashboard or API
  • Build automated email and multi-channel flows with Journeys
  • Design beautiful emails with Drag & Drop or HTML Editor
  • Use dynamic content & personalization to tailor content for each user
  • Track performance & A/B test with detailed analytics
  • Segment your audience for precise targeting
  • Integrate with CRMs & tools like HubSpot, Mixpanel, Amplitude, Zapier, and more

​
Email setup

Before sending emails, follow our quick setup guides:

Email Setup Guide

Get setup quickly with OneSignal Email or use an integration like Mailchimp, SendGrid, or Mailgun.

DNS configuration

You can automatically configure your DNS with a single click, or follow this guide to complete setup manually.

Senders

Manage multiple sender identities and domains for email deliverability.

Email Template Forwarding

Easily import existing email templates by forwarding them directly to OneSignal.”

Custom Unsubscribe Pages

OneSignal provides a default unsubscribe page for users, but you can easily create or update your own using our APIs.

​
Email deliverability

Good deliverability ensures your emails reach the inbox instead of spam. Learn more about steps you should take to ensure your emails are delivered and how OneSignal helps you with email deliverability:

Email Deliverability

All things related to email deliverability and how to improve your email sending.

Email reputation best practices

Follow this list of best practices to build and maintain a healthy sending reputation.

Auto Warm Up

How to automatically warm your email subdomain within OneSignal.

Google Postmaster Tools

Learn how and why you should set up Google Postmaster Tools.

Suppressions

Manage suppressed emails in OneSignal.

​
Design your emails

You can create visually compelling emails with:

Drag & Drop Editor

Design emails with a drag-and-drop editor.

HTML Editor

Design emails with an HTML editor.

Templates

Use pre-built templates to get started.

Unsubscribe Links & Headers

Manage email unsubscribe behavior, including unsubscribe links, List-Unsubscribe headers, and more.

Message Personalization

Use dynamic content to personalize emails for each user.

Multi-Language Messaging

Learn how to send emails in multiple languages.

​
Send emails

You can send messages in several ways based on your needs.

A/B Testing

Test up to 10 email variants.

Journeys

Build automated email and multi-channel flows with Journeys.

API

Send emails programmatically using our REST API.

Send via Dashboard

Continue this guide to learn how to send email campaigns from the OneSignal dashboard.
Steps for sending messages with the OneSignal dashboard:

Select the message channel

  • On the left sidebar, select + Create… > Email or at the top right corner, select New Message > New Email.
  • You can also navigate to Messages > Email to see previous dashboard-created messages.

Choose a composition method

Set a name and label

  • Add internal tracking metadata.
  • API equivalent: name

Set targeting audience

The users eligible to receive the message. You can include and exclude Segments to target specific users.
  • Send to default segment: Defaults to all “Subscribed Users” if none set.
  • Send to specific segments: Include and exclude segments explicitly. Multiple segments have an “OR” relationship; duplicate Subscriptions are automatically removed.
Targeting methodDashboardAPI
Segments✅✅
Filters (API only)❌✅
Aliases (API only)❌✅

Schedule and delivery options

  • Intelligent Delivery: Optimizes send times based on user activity patterns (opens, clicks from humans, not bots).
  • Custom Time per User Timezone: Sends at a set time in each user’s timezone (fallback available).
    • API parameter: delayed_option & delivery_time_of_day

​
Sender

Set your from name, sending domain, from email address & reply-to email address. Multi-domain sending is available! See Senders. API fields:
  • email_from_address
  • email_sender_domain
  • email_reply_to_address
Select your from name, from address and sending domain

​
Subject & preheader text

Set your Subject (required) and preheader text (optional). Not all inboxes display the Preheader text.
Edit your subject line, template and settings
Advanced features
Options available when creating your message. These are the same on both Drag-and-Drop or HTML editors.
Link tracking is enabled by default. Multi-link tracking is available. See Links and Deep Linking for more details.

​
Send to unsubscribed users

You can enable Include sending to unsubscribed users for compliance or non-marketing emails. This means any unsubscribed email Subscriptions that fit the segments will be sent the email.

​
Delivery schedule

When the email sends:
  • Immediately: Sends right now.
  • Specific Time: A day and time up to 30 days in advance.
    • API parameter: send_after
  • Auto Warm-Up: Slowly increases volume over a period of time. Best for new senders and new sending domains.
Select and edit Auto Warm Up
Per-user optimization
  • Send to everyone at the same time: Best for urgent messages.
  • Intelligent Delivery: Optimizes send times based on the user’s email activity patterns (opens, clicks from humans, not bots).
    • API parameter: delayed_option: last-active
  • Custom Time per User Timezone: Sends at a set time in each user’s timezone (fallback available).
    • API parameter: delayed_option: timezone & delivery_time_of_day
Example shows the email will start sending Jan 22nd at 10AM your time, and will be delivered to each user at 10AM in their timezones with a fallback time to UTC-8 (Pacific Time) if the email address doesn't have a timezone set.

​
Finalize your email

  • The “start sending” time is the cutoff point for users to enter/exit the audience segments. Anyone in the audience at this time will be sent the message and it does not depend on the “per user optimization” options.
  • Click Review & Send or Save as Draft to edit later.
You are all set to start sending emails! Next steps include: