Key API identifiers
This post lists essential identifiers used in Pushwoosh API requests. These identifiers are required for authentication, message creation, targeting, segmentation, tracking, and managing users across your applications.
General identifiers
Section titled “General identifiers”Application code
Section titled “Application code”A unique identifier assigned to each application in your Pushwoosh account. It is required in most API calls to specify the target app.
Where to find it
Pushwoosh Control Panel → Below the application name.
API access token
Section titled “API access token”A unique token assigned to a Pushwoosh account, used to authenticate API requests. It enables access to manage projects, send messages, modify settings, and retrieve data. Each account has at least one token created by default. Learn more
Where to find it
Pushwoosh Control Panel → API Access.
Device identifiers
Section titled “Device identifiers”Hardware ID
Section titled “Hardware ID”A unique identifier assigned to a device by the Pushwoosh SDK. Automatically set by the SDK or passed during device registration. Learn more
Where to find it
In device logs. Learn more
In User Explorer when searching by User ID
In the CSV file downloaded from the Segments list
Push token
Section titled “Push token”A token issued by platform providers that identifies an app-device pair for delivering push notifications. Collected automatically by the SDK when push permissions are granted. Learn more
Where to find it
In device logs. Learn more
In User Explorer, enter the HWID in the search field to find the associated device, then open the device details to view the push token.
Device type
Section titled “Device type”Indicates the platform of the target device using a numeric code. Set automatically by the SDK.
Supported values:
1 – iOS3 – Android7 – macOS8 – Windows9 – Amazon10 – Safari11 – Chrome12 – Firefox14 – Email17 – Huawei18 – SMS21 – WhatsApp22 – Line
User identifiers
Section titled “User identifiers”User ID
Section titled “User ID”A custom identifier assigned to a user, enabling cross-device and personalized targeting. Learn more
Where to find it
Pushwoosh Control Panel → Audience → User Explorer
Messaging identifiers
Section titled “Messaging identifiers”Message code
Section titled “Message code”A unique identifier assigned to each message upon creation. It follows a specific format: XXXX-XXXXXXXX-XXXXXXXX.
This code is essential for:
- Tracking the status and delivery of a specific message.
- Canceling (or deleting) a previously sent message.
- Getting message statistics.
Where to find it
- Pushwoosh Control Panel: Navigate to Message history, then open the properties of the desired message. The Message Code will be displayed there.
/createMessage
API response: When creating a new message via the API, the Message Code is included in the response.
Content identifiers
Section titled “Content identifiers”Preset code
Section titled “Preset code”An identifier for a saved message preset (for example, push or SMS). Learn more
Where to find it
Pushwoosh Control Panel → Content → Presets.
You can find the preset code in two places:
In the list view, displayed below the preset name.
In the URL when editing or creating a preset (it’s the last part of the URL).
Example:
URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB
Preset code: AAAAA-BBBBB
Rich media code
Section titled “Rich media code”Identifier for a rich media template. Learn more
Where to find it
Pushwoosh Control Panel → Content → Rich media.
Example:
URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics
Rich media code: AAAAA-BBBBB
Email content code
Section titled “Email content code”The email content code is a unique identifier for saved email content. Learn more
Where to find it
Pushwoosh Control Panel → Content → Email content.
The code is the last part of the URL.
Example:
URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB
Email content code: AAAAA-BBBBB
Campaign identifiers
Section titled “Campaign identifiers”Campaign code
Section titled “Campaign code”A unique identifier used to reference a specific campaign for tracking, and analysis.
Where to find it
The campaign code appears in the URL when viewing campaign-related statistics in the Pushwoosh Control Panel. To locate it, go to Statistics → Aggregated statistics, click on the desired campaign, and copy the code found at the end of the URL.
Example:
URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY
Campaign code: YYYYY-YYYYY
Journey ID
Section titled “Journey ID”A unique identifier used to associate messages with specific marketing campaigns for tracking and performance analysis.
Where to find it
The Journey ID appears in the URL of the campaign canvas in the Pushwoosh Control Panel.
Example:
URL: https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
Journey ID: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
Segmentation and targeting identifiers
Section titled “Segmentation and targeting identifiers”Segment / Filter name
Section titled “Segment / Filter name”The name of a predefined user segment created in Pushwoosh for audience targeting. Learn more
Where to find it
Pushwoosh Control Panel → Segments.
Segment / Filter code
Section titled “Segment / Filter code”A unique code in the format XXXXX-XXXXX that identifies a segment (also called a filter) in Pushwoosh. This code is used in API calls, automation logic, and dynamic segmentation rules.
Where to find it
You can find the segment code in the segment definition preview inside the Segments section of the Pushwoosh Control Panel. The filter code appears at the beginning of the targeting logic.
Example:
Tag("XXXXX-XXXXX", "In-app Purchase", noteq, "0.00")
In this case, XXXXX-XXXXX
is the filter (segment) code.
A custom attribute assigned to users or devices. Used for dynamic segmentation and personalization. Learn more
Where to find it
Pushwoosh Control Panel → Tags or via /getTags
API.
Event identifiers
Section titled “Event identifiers”Event name
Section titled “Event name”The name of a tracked event (e.g., purchase
, login
, subscription
). Used to trigger automated workflows or for analytics. Learn more
Where to find it
Pushwoosh Control Panel → Audience → Events.
Geolocation identifiers
Section titled “Geolocation identifiers”Geozone ID
Section titled “Geozone ID”Identifies a geofenced area used to trigger location-based notifications. Learn more
Where to find it
Pushwoosh Control Panel → Geozones.