Moengage (Cohort Sync)

The MoEngage integration sends targeted behavioral audiences from Amplitude to MoEngage. Use Amplitude cohorts to drive tailored email, SMS, push, and in-product messaging.

Considerations

To use this integration, you need a MoEngage account, an understanding of Amplitude behavioral cohorts, and an Amplitude user property that matches the User ID field in MoEngage.

Set up the integration

MoEngage setup

1. Log in to your MoEngage dashboard and go to Settings > API Settings.
2. Copy the App ID and Secret Key.

Amplitude setup

1. In Amplitude Data, click Catalog and select the Destinations tab.
2. In the Cohort section, click MoEngage.
3. Enter a name and app ID.
4. Map your user ID and device ID. The unique user ID must be the same in both Amplitude and MoEngage. This integration uses the device ID to map anonymous users, so the device ID must also be the same in Amplitude and MoEngage.

Send a cohort

1. In Amplitude, open the cohort you want to export. Click Sync, and choose MoEngage.
2. Choose the destination.
3. Select the sync cadence.
4. Save your work.

In MoEngage, the cohort appears as a custom segment with the name [Amplitude][Cohort Name].

Troubleshooting

Resolve invalid characters errors when syncing cohorts

MoEngage doesn't accept certain special characters in cohort names, including colons (:), parentheses (()), and similar symbols. Amplitude sends your cohort name to MoEngage in the format [Amplitude][Cohort Name], so special characters in the original name carry through and can cause the sync to fail.

To resolve this, rename your cohort in Amplitude to use only letters, numbers, spaces, and hyphens. After you rename the cohort, refresh the page and start a new sync.