Skip to content

Send push

Client SDK
Backend API
Mobile approve
SSO
Sub-journey

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.

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.

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.

Before users can receive push notifications, a push token must be registered so the user’s device can accept them. To send push notifications to the Android device, it needs to support Google Play Services.

Configuration

FieldDescription
TitleThe title of the push notification shown on the device. Supports expressions.
TextThe body text of the push notification shown on the device. Supports expressions.
Custom FieldsJSON object with key–value pairs to include in the notification payload.
Push TokenExpression that resolves to the push token of the recipient device. Push tokens are collected via the Mobile SDK when registering the device.
Push ProviderSelect the push service from the list of external connections. If the list is empty, create a connection (Management > Integration hub).