Articles in this section

See more

Amplitude + Iterable Integration

Amplitude can automatically ingest information about Iterable system events, helping you better understand how your users engage with your email, push, in-app, SMS, and web push campaigns—and how this engagement affects their usage of your app or website. Amplitude can also export and sync behavioral cohorts back to Iterable.

Sending data from Iterable to Amplitude

To send data to Amplitude, Iterable uses system webhooks.

NOTES

Amplitude’s user_id maps to Iterable’s userId. If these fields don't match, events won't be sent to the correct user profile in Amplitude.

  1. In Amplitude, find your project's API key by navigating to Settings > Projects > Your Project.

    Amplitude API key location

  2. Work with your Iterable customer success manager to:

    • Get the Iterable authentication key, which you'll use when configuring a system webhook in Iterable that calls out to Amplitude (see step 3).

    • Enable a feature flag to include userId values in system webhook calls.

  3. In Iterable, create a new system webhook:

    System webhook for Amplitude

    • For Endpoint URL, enter https://api.amplitude.com/iterable.

    • For Auth Type, select Basic.

    • For Authentication Token, enter your Amplitude's project API key, and the Iterable authentication key, using this format: <AMPLITUDE_API_KEY>:<ITERABLE_AUTHENTICATION_KEY>

      NOTE

      Contact your Iterable CSM to obtain the <ITERABLE_AUTHENTICATION_KEY>

    • Set Status to Enabled.

  4. With this system webhook enabled, data will begin flowing from Iterable to Amplitude.

Exporting and syncing behavioral cohorts from Amplitude to Iterable

To export behavioral cohorts from Amplitude to Iterable:

  1. Add your Iterable project's Server-side API key to Amplitude. To do this, navigate to Sources & Destinations > Destinations > Add Destination and click Iterable.

  2. Create a new cohort, or navigate to the one you'd like to export from Amplitude. To learn more about the different types of cohorts that can be created, read Amplitude's documentation.

  3. To export the selected cohort's users to Iterable, click Export. This will create an Iterable list that you can use to send campaigns. This list will have the same name as the behavioral cohort in Amplitude.

  4. To keep your list up-to-date, use Amplitude's cohort sync. After selecting the cohort you'd like to sync, click Advanced Preferences to bring up a dialog that will allow you to enable or disable this feature. A notification will appear at the top of each cohort that you're syncing, describing the sync frequency and last sync. You'll also see a way to perform a manual sync. For more information, check out Amplitude's documentation.

More information

For more information, see Amplitude's documentation for integrating with Iterable, or contact your Iterable customer success manager.

Related articles