Follow these steps to send emails from your OneSignal dashboard. Ensure you have completed the Email Setup process before proceeding.

For first-time users, we recommend using Email Auto Warm-Up and reviewing Email Deliverability best practices.

You can send Email with OneSignal using several options:

• OneSignal Dashboard: Demonstrated in this guide.
• Create message API Send email, push, and SMS via our server-side API.
• Journeys: Create emails, in-app messages, push notifications and SMS with a no-code visual builder.
• Integrations (e.g., HubSpot)

---

Requirements

Before sending emails, ensure you have:

• Completed the Email Setup.
• Understand Email deliverability including Email Acceptable Use Policy & Code of Conduct.
• Learn more about email Subscriptions.
• For new senders: Use Email Auto Warm Up.

---

Send email from the OneSignal dashboard

Navigate to Messages > Email > New Email

Dashboard-only features:

• Test & Preview – Check formatting before sending.
• Dynamic Content: Personalize notifications dynamically for individual users (Dynamic Content).
• A/B Testing: Test up to 10 notification variants (A/B Testing).
• Test Devices: Send notifications to specific test users (Set Test Subscriptions).
• Auto Warm Up: Make sure to follow best practices for Email deliverability.

---

Select your target audience

You can target users via:

Segments

Select Segments to target or exclude specific users:

• Send to default segment: Uses your 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 subscription are automatically removed.

---

Sender

Set your sender name, email & reply-to email address. Multi-domain sending available. Manage Senders in Settings > Email > Sender.

API fields:

• email_from_address
• email_sender_domain
• email_reply_to_address

---

Create your message

• Optional: Provide internal Message Name
  • API name parameter
• Choose composition method:
  • Start from scratch with our Drag & Drop Editor or HTML Editor.
  • Use pre-built designs: Templates, Previous messages.
  • API parameters: email_body accepts HTML or use template_id

Subject and Prehader text

Set your Subject (required) and Preheader text (optional). Not all inboxes display the Preheader text.

• API parameters: email_subject and email_preheader.
• Supports: Emojis 👍 (may be limited by inbox provider), Message Personalization, Multi-language messaging

Advanced settings

• Track link clicks. Enabled by default.
  • Disable with disable_email_click_tracking when sending via API.
• Send to unsubscribed users (for compliance emails only).
  • Enable with include_unsubscribed when sending via API.

---

Delivery Schedule

• Send Now or schedule up to 30 days in advance.
  • API send_after parameter.
• First-time senders should use Email Auto Warm-Up.

Per-User Optimization

• Send to everyone at the same time: Best for urgent messages.
• Intelligent Delivery: Optimizes send times based on user activity patterns.
  • API delayed_option: last-active parameter
• Custom Time per User Timezone: Sends at a set time in each user's timezone (fallback available).
  • API delayed_option: timezone & delivery_time_of_day parameters

---

Finalizing 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're ready to send your first email!

You are all set to start sending emails! Next steps include:

• Explore Email Design Options & Drag and Drop Editor.
• Learn about Message Personalization.
• Manage Unsubscribe Links & Email Subscriptions or create a Custom Unsubscribe Page.

---