Getting Started
1
Create or Select a Project
Set up a new project or select an existing one. See Organizations & Projects.
2
Configure the Connector
Enable the connector and set up a Connector Profile in your project. See Setup Connector Profile.

Optionally, configure receiving Events for Pushwoosh into StackOne.
Connector Profile · API Token (Server and Device)
Recommended. Uses both a Pushwoosh Server API token and a Device API token, so one account can run every action, includi…
Connector Profile · API Token (Server)
Uses a Pushwoosh Server API token. Covers every management, messaging and statistics action, but cannot register users,…
Connector Profile · API Token (Device)
For setups that only send device, user, tag and event data into Pushwoosh. Uses a Device API token, which cannot call ma…
Webhooks setup
3
Link an Account
Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:


Link Account · API Token (Server and Device)
Link Account · API Token (Server)
Link Account · API Token (Device)
4
Use Actions
Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.
Actions
|
No auth methods found
150 actions
Action
Description
Validate Apple Pass
Checks a pass configuration against Apple’s specifications without creating a file. Useful before calling create.
Create Apple Pass
Generates, signs, and stores a new pass, then returns its server-assigned serial number.
Update Apple Pass
Regenerates the pass with new content, re-signs it, increments its update tag, and sends a silent push notification to e…
List Apple Passes
Returns a paginated, sorted list of the passes stored for an application.
Get Apple Pass
Returns a single stored pass, including its full pass object.
Download Apple Pass
Returns the stored .pkpass file of an existing pass.
Delete Apple Pass
Removes a pass record and its stored .pkpass file.
List Apple Pass Registrations
Lists the devices that have added the pass and are registered for updates.
Get Apple Wallet Configuration
Returns the PassKit configuration resolved for an application from its certificate.
List Apple Pass Templates
List the available pass templates, or fetch one as a pass object you can use as a starting point.
Get Apple Pass Template
Fetch a template as a pass object you can use as a starting point.
Create Application
Creates a new application on the account.
Update Application
Updates the application settings.
Delete Application
Deletes the app from the account.
Get Application
Gets details about the app.
List Applications
Gets the list of applications on the account. Can return result with pagination.
Get Application File
Gets the configuration files related to the app.
Set Application Platform Status
Changes the platform’s status of the app.
Configure Application Platform
Configures the platform for the app. All platforms use the same /configureApplication method; parameters differ per plat…
Bulk Set Tags
Sets tag values for the list of devices.
Get Bulk Set Tags Status
Returns the status of
/bulkSetTags operationBulk Register Devices
Registers multiple devices in Pushwoosh in a single request. It also allows specifying various tags for each device.
Get Bulk Register Devices Status
You can check the status of a bulk registration process by making the following GET request.
Bulk Unregister Devices
Unregisters multiple devices from Pushwoosh in a single request.
Get Bulk Unregister Devices Status
You can check the status of a bulk un-registration process by making the following GET request.
Create Campaign
Creates a push campaign within the app.
Delete Campaign
Deletes a particular campaign.
List Campaigns
Retrieves the list of campaigns for the app.
List Control Groups
Lists every control group configured for an application, the unnamed original one first.
Create Control Group
Creates a named control group for an application and returns it with its generated code. The new group holds users out o…
Get Control Group
Returns one control group by its code, with its hold-out size, generation, and the user counts behind it.
Update Control Group Percentage
Sets the hold-out percentage (1–20) of one control group. Resizing keeps every existing member: the hold-out grows or sh…
Update Control Group Countries
Sets the countries one control group is scoped to. Changing the scope restarts the uplift measurement, because the popul…
Update Control Group Settings
Applies a control group’s size, country and tag scope, and lifetime mode in one call. A change that alters who is held o…
Rename Control Group
Sets the name the Control Panel shows for one control group.
name is part of the membership key and doesn’t change, so…Disable Control Group
Switches one control group off, keeping it and its generation so that switching it back on restores the same hold-out ra…
Reshuffle Control Group
Redraws one control group’s hold-out by incrementing its generation. This is the only way to get a different sample: mem…
Force Recalculate Control Group
Starts a fresh count of one control group’s size. The previously cached numbers keep being served until the new count fi…
Get Control Group Calculation Status
Polls just the changing user counts of one control group while a size calculation runs.
Get Control Group Analytics
Returns the precomputed Control-vs-Treatment analytics for one control group.
List Control Group Cycles
Lists the closed cycles of one control group, newest first. Each cycle is the membership the group ran with between two…
Check Control Group Membership
Reports for each user ID whether it is held out by one control group right now. Membership is computed from the ID alone…
Delete Control Group
Removes a control group entirely. It stops holding users out, and its statistics can no longer be opened. The applicatio…
Create Data Erasure Task
Starts erasing the personal data of the listed subjects in the listed applications. With
dry_run: true the task only c…Get Data Erasure Journal Report
Returns every erasure of a period as one CSV file: a row per identifier per application, with the task and its initiator…
Get Data Erasure Task
Returns one erasure task with its status and counters. Use it to follow a task started by Create or Upload.
Get Data Erasure Task Report
Returns the whole report of one task as a CSV file: one row per identifier per application, with its outcome. ListTaskRo…
List Data Erasure Task Rows
Returns the per-identifier outcome of one task: what was deleted, not found, skipped, or failed. Identifiers are reporte…
List Data Erasure Tasks
Lists the erasures of the account, newest first: the audit journal of who erased what and when. Dry runs are left out un…
Upload Data Erasure CSV
Creates the same kind of task as Create, but the identifiers come from an uploaded CSV instead of a JSON array. Use this…
Delete Device
Deletes a device and all its associated data identified by the specified HWID within the application. Unlike /unregister…
Get Device Tags
Retrieves a list of tags with corresponding values for the specific device.
Register Device
Called internally from the SDK. Registers device for the application.
Set Badge
This endpoint is disabled. The server no longer stores or acts on the badge value it receives. Badge state is managed en…
Set Device Tags
Sets tags values for the device. Called from the SDK.
Track Application Open
Registers an app open event. Called internally from the SDK.
Track Message Delivery
Registers push delivery event for the device. Called internally from the SDK.
Track Push Open
Registers a push open event. Called internally from the SDK.
Unregister Device
Removes the device’s push token. The unregistered device is still counted in Total Devices and can be reached with In-Ap…
Register Email
Registers email address for the app.
Delete Email
Removes email address from your user base.
Set Email Tags
Sets tag values for the email address.
Register Email User
Associates an external User ID with a specified email address.
Create Email Template
Creates a new email template - its editor content plus a connected email preset - in an application, and returns the gen…
List Email Templates
Lists an application’s email templates - metadata only, no content - with paging, ordering, and filtering by name, label…
Get Email Template
Returns a single email template by its code, including sender info, per-locale subjects, and the full editor content.
Update Email Template
Updates an existing email template by code, overwriting the supplied fields.
Delete Email Template
Deletes an email template and its connected preset by code, removing the stored content.
Clone Email Template
Clones an email template - its content and preset - into a destination application, optionally under a new name.
Create Event
Creates an Event for the app.
Get Nearest Geozone
Called internally from the SDK. Retrieves the parameters of the nearest geozone and the distance to it. Also records the…
Create Geozone
Adds a Geozone to a specific app.
Update Geozone
Updates Geozone properties.
Delete Geozone
Removes Geozones from the app.
Create Geozone Cluster
Adds Geozone Cluster to the app.
Delete Geozone Cluster
Removes a Geozone Cluster from the app.
List Geozones
Retrieves a list of Geozones for the app.
List Geozone Clusters
Retrieves a list of Geozone clusters for the app.
Validate Google Pass
Checks a pass configuration against Google’s requirements without creating it. Useful before calling create.
Create Google Pass
Creates the pass class and object in Google Wallet, then returns the server-assigned serial number, the full object id,…
Update Google Pass
Patches the pass object with new content. Google then delivers the updated version to every device that saved the pass…
Get Google Pass Save Link
Returns an “Add to Google Wallet” save link for an already created pass. The pass object must already exist (created via…
Get Google Pass
Returns a single stored pass, including its full pass object.
List Google Passes
Returns a paginated, sorted list of the passes stored for an application.
Set Google Pass State
Activates or invalidates a pass. An invalidated (inactive) pass moves to the user’s Expired passes section in Google Wal…
Delete Google Pass
Invalidates the pass in Google and removes its stored record in Pushwoosh.
Get Google Wallet Configuration
Returns the Google Wallet configuration state for an application.
List Google Pass Templates
List the available example pass templates, or fetch one as a pass object you can use as a starting point.
Get Google Pass Template
List the available example pass templates, or fetch one as a pass object you can use as a starting point.
Get Inbox Messages
Returns the list of Inbox messages for a specified HWID.
Update Inbox Message Status
Updates the status of a particular Inbox message.
Create Journey
Creates a new journey in the STATUS_DRAFT state.
Update Journey
Replaces the definition of an existing journey. Send the complete definition. The points and comments you submit replace…
Rename Journey
Changes only the journey title, without touching its points or settings.
Start Journey
Moves a journey to STATUS_RUNNING. Pass the Journey ID as uuid in the request body. Returns the updated journey object.
Pause Journey
Moves a journey to STATUS_PAUSED. Pass the Journey ID as uuid in the request body. Returns the updated journey object.
Finish Journey
Moves a journey to STATUS_FINISHED. Pass the Journey ID as uuid in the request body. Returns the updated journey object.
Archive Journey
Moves a journey to STATUS_ARCHIVED. Pass the Journey ID as uuid in the request body. Archived is terminal and cannot be…
Start Journey For Users (API Entry)
Enters a set of users into a journey’s API entry point. Use it to drive journeys from your own backend.
Get Journey Stats
Returns statistics for a Customer Journey by its ID.
Remove Users From Journeys
Removes a list of users from all or specific active journeys.
Start Live Activity
Allows creating iOS Live Activities.
Update Live Activity
Allows updating and ending iOS Live Activities
Notify (Send Message)
Creates and schedules a single message.
Cancel Message (v2)
Cancels a previously created message, identified by its message_code. Cancellation is available only while the message i…
Update Scheduled Message (v2)
Replaces a previously created message, identified by its message_code, with a new definition. The replacement is a full…
Delete Message
Deletes a message, whether it’s still scheduled or has already been sent. For a scheduled message, this also removes it…
Get Message Details
Retrieves the message details.
Create Preset
Creates a new push preset in an application and returns it with its generated code.
List Presets
Lists an application’s push presets - a reduced field set, not the full object - with paging, ordering, and filtering by…
Get Preset
Returns a single push preset by its code, with every field of the Preset object populated.
Update Preset
Overwrites an existing push preset by code with the supplied fields.
Update Preset Partially
Updates only the supplied fields of an existing push preset by code, leaving unset fields unchanged.
Clone Preset
Duplicates an existing push preset, under a new name, into the same application.
Delete Preset
Permanently deletes a push preset by code.
Get Scheduled Request Results
Retrieves the result of a scheduled request.
Create Segment (Filter)
Creates a new filter.
List Segments (Filters)
Returns a list of available segments (filters) with their conditions.
Delete Segment (Filter)
Deletes an existing filter.
Export Segment
A scheduled request. Exports the list of subscribers that fall under specified Filter conditions.
Get Segment Export Result
Retrieves the link to the CSV with the /exportSegment results.
List Sent Messages
Displays the list of sent messages.
Get Message Totals By Intervals
Returns metrics and conversion data based on the message code, aggregated by hour.
Get Delivery Funnel
Returns one message’s funnel.
Get Campaign Delivery Funnel
Sums getDeliveryFunnel over a campaign’s messages. Unique counts are calculated per message: a subscriber reached by sev…
Get Message Log
Displays detailed information about the messages sent.
Get Email Links Interactions
Displays statistics on link clicks in emails
List Email Link Clickers
Shows users who clicked on links in emails
List Bounced Emails
Provides data on email complaints, soft bounces, and hard bounces, including the date, email address, and reason for eac…
Get Application Subscribers Stats
Displays the app’s subscribers list grouped by the types of their devices.
Get App Stats
Get the statistics of a specific app for a defined time period.
Get Subscribers Statistics
Retrieves app subscribers stats for a time period.
Get Campaign Stats
Retrieve statistics of a particular campaign for a specific time period.
Get Event Statistics
Retrieves the number of times an event was triggered during a specified period.
Get Tag Stats
Retrieves statistics for a specific tag.
Get In-App Totals
Returns totals for the period. Pass inapp_codes to report on specific campaigns, or omit it to walk every in-app of the…
Export Messages Statistics
Queues a message history export and returns a task identifier right away.
Get Messages Statistics Export Status
Returns the progress of an export task.
Get Messages Statistics Export Result
Returns the generated file name once the task has completed.
List Messages Statistics Exports
Lists recent export tasks for an application, most recent first.
Delete Messages Statistics Export
Deletes a task and its file before the 7-day retention window expires.
Download Messages Statistics Export
Downloads the CSV file generated by
result, by name.Create Tag
Creates a tag in your account.
Delete Tag
Completely removes a tag with all the associated information from the database.
List Tags
Retrieves a list of tags on the account.
Create Test Device
Registers a test device for the application.
List Test Devices
Returns all the test devices for the specific application.
Register User
Associates external User ID with a specified device.
Delete User
Deletes a user and all devices associated with the specified User ID within the application. The request is processed as…
Post Event
Triggers an event.
Events
|
No tags found
16 events
Event
Description
Tags
Push Sent
Fired when Pushwoosh sends a push notification to a device.
MessagesWebhooks
Push Delivered
Fired when a push notification is delivered to a device.
MessagesWebhooks
Push Opened
Fired when a user opens a push notification.
MessagesWebhooks
Email Sent
Fired when Pushwoosh sends an email.
EmailsWebhooks
Email Delivered
Fired when an email is delivered to the recipient’s mail server.
EmailsWebhooks
Email Opened
Fired when a recipient opens an email.
EmailsWebhooks
Email Bounced
Fired when an email bounces with a permanent error.
EmailsWebhooks
Email Unsubscribed
Fired when a recipient unsubscribes through an email.
EmailsWebhooks
SMS Sent
Fired when Pushwoosh sends an SMS.
MessagesWebhooks
SMS Delivered
Fired when an SMS is delivered to the recipient.
MessagesWebhooks
SMS Not Delivered
Fired when an SMS fails to deliver.
MessagesWebhooks
In-App Shown
Fired when an in-app message is shown to a user (PW_InAppShow post event).
EventsWebhooks
In-App Clicked
Fired when a user clicks an in-app message (PW_InAppClicked post event).
EventsWebhooks
Device Registered
Fired when a device registers for push notifications (PW_DeviceRegistered post event).
DevicesWebhooks
Device Unregistered
Fired when a device unregisters from push notifications (PW_DeviceUnregistered post event).
DevicesWebhooks
Custom Event
Fired for any other post event, such as a custom event recorded with postEvent, when it is selected under Post events.
EventsWebhooks