How to switch from the Transactional API to the Profile API?

As part of the migration from the Batch MEP to the CEP, you might want to switch from the Transactional API (or its variant, the Partner API) to a more user-friendly option: sending custom events via the Profile API and scheduling your Trigger Push Automations directly from the Automation Builder.

This option is not applicable yet if you are targeting Installation IDs with the Transactional API. It will be available soon.

Here is how to do it:

1

Audit your current usage of the Transactional API

Establish the list of your running Transactional API calls. You can refer to the Analytics > Notifications > Transactional tab on the Batch dashboard to get the list of messages sent via the Transactional API over a specific time period.

2

[Back-end] Prepare your calls to the Profile API

  • Associate each Transactional message with a new Custom Event:

    • Event name: For consistency, you can use the "Group ID" of your current Transactional API call.

    • Additional data: If your transactional message contains personalization, associate the personalization values as attributes of these events.

  • Get ready to send these events via the Profile API each time you were calling the Transactional API.

3

[Dashboard] Prepare your Trigger Automations

  • Create one trigger automation for each transactional message using the Batch Automation Builder. The trigger event must be the one defined in step 2.

  • Activate these automations.

4

[Back-end] Switch from the Transactional API to the Profile API

Once the automations are running on the dashboard, stop calling the Transactional API and start sending the custom events via the Profile API so that the automations created in step 3 are triggered.

Last updated

Was this helpful?