Overview

With Amplitude and Cordial's cohort integration, you can sync users from Amplitude cohorts to Cordial lists. Using lists along with other contact data in Cordial, you can create dynamic segments of contacts for sending messages, searching contacts, and filtering analytics reports.

Send cohorts from Amplitude to Cordial

Cordial setup

1. Log in to Cordial, click the Settings dropdown, and select API Keys.

2. Select New on the API Keys page.

• Learn how to generate an API key here.

Amplitude setup

1. Log in to Amplitude and navigate to Data Destinations. 

2. Click View All Destinations, then select the Cordial - Cohort tile.

3. Complete the Name and API Key fields.

4. Reach out to your Cordial CSM to get your Amplitude service URL. Paste that URL into the Endpoint field.

• For us-west-1 accounts, the URL is integrations-ingest-svc.cordial.com
  • Example with custom domain alias: yourbrand.integrations-ingest-svc.cordial.com
• For us-west-2 accounts, the URL is integrations-ingest-svc.usw2.cordial.com
  • Example with custom domain alias: yourbrand.integrations-ingest-svc.usw2.cordial.com

5. In Cordial, complete the Contact identifier name field. Users will be identified by this key in Cordial. For example: email.

6. In the Contact identifier mapping dropdown, select a user property name, the value of which will be passed as the value for the contact identifier.

7. Save the destination.

After a cohort is synced, the contacts will be added to a list in Cordial. The list is named with the cohort name in Amplitude with spaces removed. For example, when the activeusers cohort with 10 users is synced to Cordial, you will see exactly 10 contacts added to the activeusers list. When a user is removed from a cohort and the cohort is synced, the contact is removed from the list. Please refer to our Lists article for details on using lists.