Send push
Sends a push notification to the user’s device
Description
This backend step is used to send a push notification to a user device using a push External Connection (e.g., APNs/FCM via your configured connector). Typical use cases include out-of-band notifications, transactional alerts, or companion messages within a journey.
When triggered, this step instructs Mosaic to send the push notification using the selected provider and the configured message fields. On success, the journey proceeds. If the step fails, the journey can follow a failure branch (if configured) or abort.
Prerequisites
Before users can receive push notifications, a push token must be registered so the user’s device can accept them.
Note
This guide documents the Send push step as a generic messaging action, not an authentication factor. To send an OTP for authentication, use the Generic OTP Authentication step, which handles OTP generation, delivery (including push), and validation in a single flow.
Configuration
| Field | Description |
|---|---|
| Title | The title of the push notification shown on the device. Supports expressions. |
| Text | The body text of the push notification shown on the device. Supports expressions. |
| Custom Fields | JSON object with key–value pairs to include in the notification payload. |
| Push Token | Expression that resolves to the push token of the recipient device. Push tokens are collected via the Mobile SDK when registering the device. |
| Push Provider | Select the push service from the list of external connections (for example, APNs or FCM). If the list is empty, create a connection (Management > Integration hub). |