Swrve’s Transactional Push API enables you to send a push notification to a single user that is triggered by an external event from a third-party system. You can configure the notification to include predefined content or create a custom message by triggering an external call to the Push API. For more information about configuring your request to the Push API, see the Swrve Push API Guide.

This article covers how to create push notification campaigns that are triggered externally using the Push API. The initial steps are very similar to creating a single push notification or recurring push notification campaign that is launched or scheduled directly in Swrve. For more details on the initial steps, see Creating Push Notifications.

Create a Transactional Push API Campaign

To create a transactional push API campaign and access the Push API key:

Click the Select a QA Device to test with list and select the QA device to which you want to send the test message.

After you select a QA device, the screen displays sample curl and HTTP POST commands relevant to this campaign and the selected QA device. Run the curl command in the terminal to send a test message to the device. Alternatively, copy the HTTP POST command to a service like https://www.hurl.it/ (remembering to use POST, not GET). You can edit the message content as required.

Step 7: If the QA test is successful, to start the campaign, click Make Active.

After you make the campaign active, you can use the Push API key and URL to trigger push notifications to individual users from a third-party system. This may be via webhooks in another marketing package (for example, Marketo) or using your own custom code. For more information on the API call method, URL parameter, expected responses and possible error codes, see the Swrve Push API Guide.

Viewing Transactional Push API Results

To view details and results for a particular campaign, click the push notification summary on the Push Notifications screen. For campaigns in any status other than Draft, the individual campaign screen displays a detailed report of your campaign results. The results reflect any users who engage with the push notifications triggered via the Push API key associated with this campaign. For more information on the individual campaign screen, see Managing Push Notifications.

Next Steps

Use the campaign-specific Push API key to send calls to the Push API. For more information, see the Swrve Push API Guide.

View results or reports for your single user Push API campaign or change the status. For more information, see Managing Push Notifications.