Details on all properties available for Event Streams and Webhooks.
String
The type of message and event (e.g. message.push.received
, message.push.sent
).
Usage: {{ event.kind }}
Message Event Kind (OneSignal) | Event name (in data set) | Event Description |
---|---|---|
Push Sent | message.push.sent | Push notification successfully sent. |
Push Received | message.push received | Push notification successfully received. See Confirmed Delivery . |
Push Clicked | message.push.clicked | Push notification touched on device |
Push Failed | message.push.failed | Push failed to be sent. Check the failed message report in OneSignal. |
Push Unsubscribed | message.push.unsubscribed | The Subscription unsubscribed from push. |
In-App Impression | message.iam.displayed | In-App Message successfully displayed on device |
In-App Clicked | message.iam.clicked | In-App Message clicked on device |
In-App Page Displayed | message.iam.pagedisplayed | In-App Message page is displayed |
Email Sent | message.email.sent | Email successfully sent |
Email Received | message.email.received | Email received by recipient |
Email Opened | message.email.opened | Email opened by recipient. See Email Message Reports for details. |
Email Link Clicked | message.email.clicked | Email link clicked on |
Email Unsubscribed | message.email.unsubscribed | Email unsubscribed by recipient |
Email Reported As Spam | message.email.reported_as_spam | Email reported as spam by recipient. See Email deliverability for details. |
Email Bounced | message.email.hardbounced | Email returned to sender due to permanent error. See Email Message Reports for details. |
Email Failed | message.email.failed | Could not deliver the email to the recipientβs inbox |
Email Suppressed | message.email.supressed | The email was not sent because the email address is on the Suppression list . |
SMS Sent | message.sms.sent | SMS sent to recipient |
SMS Failed | message.sms.failed | SMS failed to send |
SMS Delivered | message.sms.delivered | SMS successfully delivered |
SMS Undelivered | message.sms.undelivered | The SMS could not be sent |
event
object includes the following properties:
UUID
The event ID generated by OneSignal. Each event.kind
will have a unique ID. For the message ID, use message.id
.
Usage: {{ event.id }}
Integer
The UNIX timestamp of the event.
Usage: {{ event.timestamp }}
String
A human-readable time of the event in UTC (specifically an ISO string like β2024-02-21T23:45:15.228Zβ).
Usage: {{ event.datetime }}
UUID
The OneSignal App ID.
Usage: {{ event.app_id }}
String
The subscription type (e.g. iOS
, Android
, Chrome
, Email
, SMS
, etc).
Usage: {{ event.subscription_device_type }}
UUID
The OneSignal Subscription ID.
Usage: {{ event.subscription_id }}
UUID
The OneSignal created User ID.
Usage: {{ event.onesignal_id }}
String
Your User ID set as the OneSignal External ID alias. Can be empty if not set in OneSignal.
Usage: {{ event.external_id }}
String
The name of the page or card that is displayed for certain in-app message events. See In-app message Event Streams for details.
Usage: {{ event.data.page_name }}
String
A unique identifier for the page or card that is displayed for certain in-app message events. See In-app message Event Streams for details.
Usage: {{ event.data.page_id }}
String
The name of the button or image block element clicked. Must contain a In-app click action. See In-app message Event Streams for details.
Usage: {{ event.data.target_name }}
String
A unique identifier for the button or image block element clicked. Must contain a In-app click action. See In-app message Event Streams for details.
Usage: {{ event.data.target_id }}
message
object is designed to keep you informed of the messages sent to the end-user. It includes properties like id
, template_id
, and content
, which contains the actual text of the message.
UUID
The message ID generated by OneSignal.
Usage: {{ message.id }}
String
The name of the message as set in the dashboard or using the API name
property.
Usage: {{ message.name }}
Object
The title of the push message or email subject as set in the dashboard or using the API headings
or email_subject
properties.
Usage: {{ message.title }}
Object
The contents of the push or SMS message as set in the dashboard or using the API contents
property (clipped at 50 characters). Email contents (email_body
) are not provided.
Usage: {{ message.contents }}
UUID
The template ID for a message sent via Journeys or the API template_id
property.
Usage: {{ message.template_id }}
String
The messageβs launch URL (when using only one URL that is web and app agnostic). See URLs, Links and Deep Links for details.
Usage: {{ message.url }}
String
The messageβs launch URL when using both a web and app-specific URL. See URLs, Links and Deep Links for details.
Usage: {{ message.app_url }}
String
The messageβs launch URL when using both a web and app-specific URL. See URLs, Links and Deep Links for details.
Usage: {{ message.web_url }}
String
The userβs OneSignal ID.
Usage {{ user.onesignal_id }}
String
The userβs External ID.
Usage: {{ user.external_id }}
Object
The userβs tags.
Usage:
{{ user.tags }}
{{ user.tags.your_tag }}
{{ user.tags}}
."{{ user.tags.your_tag | default: '' }}"
.String
The userβs language.
Usage: {{ user.language }}
String
The ID of the subscription the message was sent to.
Usage: {{ user.subscription.id }}
String
The ID of the app.
Usage: {{ user.subscription.app_id }}
String
The token for the subscription the message was sent to.
{{ user.subscription.subscription_token }}
Number
The session count for the subscription the message was sent to.
Usage: {{ user.subscription.session_count }}
String
The language set on the subscription the message was sent to.
Usage: {{ user.subscription.language }}
String
The game version set on the subscription the message was sent to.
Usage: {{ user.subscription.game_version }}
Number
The last active time set on the subscription the message was sent to.
Usage: {{ user.subscription.last_active }}
Number
The play time set on the subscription the message was sent to.
Usage: {{ user.subscription.play_time }}
Number
The amount spent on the subscription the message was sent to.
Usage: {{ user.subscription.amount_spent }}
Number
The creation time of the subscription the message was sent to.
Usage: {{ user.subscription.created_at }}
Boolean
Indicates whether the subscription the message was sent to is currently subscribed.
Usage: {{ user.subscription.subscribed }}
String
The SDK version set on the subscription the message was sent to.
Usage: {{ user.subscription.sdk }}
String
The device model set on the subscription the message was sent to.
Usage: {{ user.subscription.device_model }}
String
The device operating system set on the subscription the message was sent to.
Usage: {{ user.subscription.device_os }}
Object
The userβs tags. You can access the entire object or specific tags.
Usage:
{{ user.tags }}
{{ user.tags.your_tag }}