Update a live notification

Push a new content state to a running activity, referenced by its instance_id. The device re-renders the activity from the state you send.

Send the full content state on every update, not just the fields that changed—the platforms don't support partial updates.

push_payload is optional on updates, whether Customer.io delivers directly through APNs or relays through Firebase Cloud Messaging (FCM). If you include a push_payload.alert, it must contain both a title and a body.

post/v1/live_notifications/update

Request body

instance_idstring required

The activity's instance ID (ULID), returned when you started it.

attributesobject

Static activity fields, for renderers that need them alongside the content state. On iOS, attributes can't change after start.

deep_linkstring

A link to open when the person taps the activity.

Response

The update was queued.

instance_idstring

The activity's instance ID.

Changes

No recorded changes to this endpoint across all 1 revision of this API.