# 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 ### 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 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](/developer/api-reference/api-access-token/) **Where to find it** Pushwoosh Control Panel → API Access. ## Device identifiers ### 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](/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) **Where to find it** * In device logs. [Learn more](/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token) * In [User Explorer](/product/audience-data-and-segmentation/user-explorer/) when searching by **User ID** * In the CSV file downloaded from the [Segments list](/product/audience-data-and-segmentation/segmentation/segments/) ### 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](/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) **Where to find it** * In device logs. [Learn more](/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token) * In [User Explorer](/product/audience-data-and-segmentation/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 Indicates the platform of the target device using a numeric code. Set automatically by the SDK. Supported values: ``` 1 – iOS 3 – Android 7 – macOS 8 – Windows 9 – Amazon 10 – Safari 11 – Chrome 12 – Firefox 13 – Internet Explorer 14 – Email 16 – Baidu Android 17 – Huawei 18 – SMS 20 – Web 21 – WhatsApp 22 – Line 23 – Kakao Talk 24 – Telegram 25 – Apple Wallet 26 – Google Wallet 27 – Viber ``` ## User identifiers ### User ID A custom identifier assigned to a user, enabling cross-device and personalized targeting. [Learn more](/developer/pushwoosh-knowledge-hub/users-userids/users-userids/) **Where to find it** Pushwoosh Control Panel → Audience → User Explorer ## Messaging identifiers ### 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 **Campaigns → One-time messages**, then open the **properties** of the desired message. The Message Code will be displayed there. * **[`/createMessage`](/developer/api-reference/messages-api/#createmessage) API response:** When creating a new message via the API, the Message Code is included in the response. ## Content identifiers ### Preset code An identifier for a saved message preset (for example, push or SMS). [Learn more](/product/content/) **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 Identifier for an in-app message template. [Learn more](/product/content/in-apps/) **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 The email content code is a unique identifier for saved email content. [Learn more](/product/content/email-content/) **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 ### 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 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 ### Segment / Filter name The name of a predefined user segment created in Pushwoosh for audience targeting. [Learn more](/product/audience-data-and-segmentation/segmentation/segments/) **Where to find it** Pushwoosh Control Panel → Segments. ### 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** - Via the [`/listFilters`](/developer/api-reference/segmentation-filters-api/#listfilters) API method. - In the address bar when viewing a segment in the Pushwoosh Control Panel: **Example:** **URL:** `https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail` **Segment code:** `XXXE9-XXX49` ### Tag A custom attribute assigned to users or devices. Used for dynamic segmentation and personalization. [Learn more](/developer/guides/audience-and-segmentation/tags/) **Where to find it** Pushwoosh Control Panel → Tags or via [`/getTags`](/developer/api-reference/device-api/#gettags) API. ## Event identifiers ### Event name The name of a tracked event (e.g., `purchase`, `login`, `subscription`). Used to trigger automated workflows or for analytics. [Learn more](/developer/guides/audience-and-segmentation/events/) **Where to find it** Pushwoosh Control Panel → Audience → Events. ## Geolocation identifiers ### Geozone ID Identifies a geofenced area used to trigger location-based notifications. [Learn more](/product/messaging-channels/push-notifications/geo-based-push/) **Where to find it** Pushwoosh Control Panel → Geozones.