How do I find the 'campaign' code for the /createMessage API call?

Note (2026): /createMessage is deprecated. New integrations should use the unified Messaging API v2 Notify endpoint; see the migration guide for a field-by-field mapping. The parameters below still work on /createMessage and map 1:1 to v2.

The campaign parameter in /createMessage corresponds to a feature called Aggregated Messages in the Pushwoosh Control Panel. This is different from the "Campaigns" found in the Customer Journey builder, and the codes from Customer Journeys cannot be used for this API parameter.

There are two ways to find the correct campaign code for your API call.

1. From the Pushwoosh Control Panel

• Navigate to Statistics → Aggregated statistics.
• Click on the specific aggregated message you want to use.
• Look at the URL in your browser's address bar. The campaign code is the value of the campaignCode parameter.

Example URL:
https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

In this example, YYYYY-YYYYY is the code you need.

2. Using the API

You can programmatically retrieve a list of all your campaigns (aggregated messages) and their codes by calling /getCampaigns, which is still fully supported:

POST https://api.pushwoosh.com/json/1.3/getCampaigns

The response includes a list of campaigns with their names and the hyphen-separated campaignCode required for the message-creation call. See the API methods reference index for the full Campaigns API.