Integrations/OneSignal
OneSignal logo

OneSignal + Courier

Turn OneSignal into a multi-channel notification system

Design and automate every message with Courier. Keep OneSignal for email delivery, then add SMS, push, and an in-app inbox from one API.

Overview

What OneSignal is

OneSignal is a customer communication platform that sends notifications and messages, including email, to users across multiple channels.

Courier sits in front of it as one API, a visual editor, journeys, and every other channel, so you keep OneSignal for delivery and build multi-channel notifications on top.

You need a Courier account and your own OneSignal account with an App ID and REST API Key.

Why Courier

What you get with OneSignal + Courier

Use cases

What teams build with it

Onboarding and lifecycle journeys that marketing can edit without engineering
Beautifully designed transactional email, receipts, welcomes, and resets, from one template set
Add SMS or push to an existing email flow without wiring a new integration
Give users an in-app inbox so they see the same messages inside your product

Setup

Connect it in minutes

An admin adds OneSignal once on the Integrations page in Courier. Once connected, anyone on your team can design and send email through OneSignal, and add channels whenever they need them.

1
Add your OneSignal credentials
Add OneSignal as an email provider and paste your App ID and REST API Key from the OneSignal dashboard.
2
Design a template
Build your email in Courier's visual editor, or import your existing content into a Courier template.
3
Send from your app
Call the Send API with a recipient and template. Courier renders and delivers through OneSignal.

FAQ

Frequently asked questions

Can I use OneSignal with Courier?

Yes. OneSignal is a push notification service, and Courier supports it as a push provider. You trigger notifications with Courier's Send API and Journeys, and OneSignal delivers them to your users' devices.

Do I still need my own OneSignal account?

Yes. Courier orchestrates but does not deliver push itself, so you keep your OneSignal app, where devices are registered and subscriptions live. Courier sends through that app; without it there is nowhere to route the notification.

What do I need to connect OneSignal to Courier?

Two values from OneSignal: your App ID and REST API Key. You enter both on Courier's OneSignal integration page, and OneSignal's own documentation shows where to find them. That connection lets Courier send through your OneSignal app.

How does Courier know which device to send a OneSignal push to?

Each recipient profile needs either a oneSignalPlayerID (their OneSignal PlayerId) or a oneSignalExternalUserId (their ExternalId) in the message's to object. At least one must be present, or the send fails.

Can I customize the OneSignal push payload from Courier?

Yes. Any field on OneSignal's Create notification endpoint can be set through the providers.onesignal.override.body object, including priority, ttl, and small_icon. This lets you tune delivery behavior beyond Courier's standard push content.

Why do some OneSignal pushes fail in automated workflows?

OneSignal caps push payload size, so batched Automations carrying large data payloads can exceed it and fail. Enable data mapping in Courier to control which data passes to the push channel and stay under the limit.

Is Courier a replacement for OneSignal?

No. OneSignal still delivers every push to your users' devices. Courier adds one API for content design, Journeys, and other channels like email, SMS, and Courier Inbox, so OneSignal becomes one channel in a multichannel stack.

More

Related integrations