← Tools Reference

OneSignal

OneSignal integration (Communication, Marketing). Imported from open-connector.

API key4 toolshttps://api.onesignal.com
POST
onesignal_rest_api_create_push_notification
Create a push notification for the connected OneSignal app using one official targeting method.

/notifications

17 parameters
ParamTypeRequiredDescription
contentsobjectoptionalLocalized push notification body keyed by language code.
headingsobjectoptionalLocalized push notification title keyed by language code.
subtitleobjectoptionalLocalized push notification subtitle keyed by language code.
namestringoptionalOptional OneSignal message name.
included_segmentsarrayoptionalSegments targeted by this push notification.
excluded_segmentsarrayoptionalSegments explicitly excluded from delivery.
include_aliasesobjectoptionalMapping of OneSignal alias labels to one or more alias values.
include_subscription_idsarrayoptionalDirect subscription ids targeted by this push notification.
filtersarrayoptionalOneSignal filter objects used as the targeting method.
template_idstringoptionalThe OneSignal template UUID.
send_afterstringoptionalScheduled delivery time string accepted by OneSignal.
urlstringoptionalOptional URL to open from the notification.
web_urlstringoptionalOptional web URL to open from the notification.
app_urlstringoptionalOptional app deep link to open from the notification.
dataobjectoptionalCustom push data included in the message payload.
custom_dataobjectoptionalTemplate personalization data included in the request.
content_availablebooleanoptionalWhether to set content_available for silent delivery.
GET
onesignal_rest_api_list_messages
List messages from the connected OneSignal app.

/notifications

5 parameters
ParamTypeRequiredDescription
limitintegeroptionalMaximum number of messages to return.
offsetintegeroptionalPagination offset for the message list.
kindnumberoptionalThe OneSignal message kind filter: 0 for API-created, 1 for automated, or 3 for…
template_idstringoptionalThe OneSignal template UUID.
time_offsetstringoptionalThe sequential time_offset token returned by OneSignal.
GET
onesignal_rest_api_get_message
Retrieve one OneSignal message by id from the connected app.

/notifications/{messageId}

2 parameters
ParamTypeRequiredDescription
message_idstringrequiredThe OneSignal message identifier.
messageIdstringrequiredPath parameter: messageId
DELETE
onesignal_rest_api_cancel_message
Cancel one scheduled OneSignal message by id.

/notifications/{messageId}

2 parameters
ParamTypeRequiredDescription
message_idstringrequiredThe OneSignal message identifier.
messageIdstringrequiredPath parameter: messageId