> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync Amplitude cohorts

> Sync cohorts from Amplitude to Notifly user groups and use those groups as campaign audiences.

> [!TIP]
>
> The Amplitude integration is available on Notifly's Pro and Enterprise plans. Available sync schedules depend on your [Amplitude plan](https://amplitude.com/docs/data/destinations/syncs).

A synced Amplitude cohort appears as a user group that you can target in Notifly campaigns. See [Notifly (Cohort Sync) in the Amplitude docs](https://amplitude.com/docs/data/destination-catalog/notifly-cohort-sync).

* Send a reminder with a discount to users who left items in their cart.
* Introduce a new feature through in-app popups and push notifications to users who haven't tried it.
* Send a series of personalized messages, such as offers or updates, to users who haven't opened the app in at least 30 days.

## Before you start

* The integration maps an Amplitude user ID or a selected user property to Notifly's `external_user_id`.
* Each user needs an ID in both Amplitude and Notifly. The integration excludes anonymous users.
* Notifly creates one user group per cohort. If you sync the same cohort through a new destination, Notifly resets the existing user group. Review the new destination's user ID mapping before syncing.

## 1. Get your Notifly credentials

1. In the Notifly console, open **Settings** > **Product & Project**.
2. Copy your **Project ID**.
3. Under **API Credentials**, copy your **Access Key**. Copy the **Secret Key** from the dialog that appears when you create or renew it. For an existing Secret Key, ask your development team.

> [!NOTE]
>
> Store the Secret Key only on the server. Notify your development team before renewing it.

## 2. Add the destination in Amplitude

1. In Amplitude **Data**, go to **Catalog** > **Destinations**.
2. In the **Cohort** section, select **Notifly**.

   > [!NOTE]
   >
   > If you don't see Notifly, contact Amplitude.

![Cohort destinations in Amplitude](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/amplitude/amplitude-catalog.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=30f7e99f8168b46d14b3607711cb2fb0)

3. Enter a name in **Name**. Paste the Notifly Access Key into **API Key**, the Secret Key into **Secret Key**, and the Project ID into **Project Id**.

   > [!NOTE]
   >
   > Copy the Secret Key before closing the dialog that appears when you create or renew it. To get an existing key, ask your development team.

![Notifly cohort destination dialog in Amplitude](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/amplitude/amplitude-connect-notifly-modal.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=bbefb041e4c74521b6061e5f5c4fcd9d)

4. Map the Amplitude user ID to Notifly's `external_user_id`. You can use a predefined or custom Amplitude user property as the user ID.

> [!NOTE]
>
> For each user you want to sync, confirm that the value in the selected Amplitude field matches the user’s `external_user_id` in Notifly.

5. Click **Save**.

## 3. Send the cohort

1. In Amplitude, open the cohort to send to Notifly.
2. Open the cohort's sync options and select **Notifly**.

![Select Notifly as the cohort sync destination](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/amplitude/amplitude-select-notifly-sync.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=27cb46aac446560bc3fa45240ffce886)

3. Under **Select an API target to sync to**, choose the destination you created, then click **Next**.

![Select the configured Notifly destination](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/amplitude/amplitude-cohort-sync-type.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=aded036ea19a3f0c261e63c39805f169)

4. Choose a sync frequency. The options depend on your plan and destination.
   * **One-Time Sync** runs once.
   * **Scheduled Sync** runs hourly or daily.
   * **Real-Time Sync**, if available, sends updates every minute.

![Available cohort sync frequencies](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/amplitude/amplitude-cohort-sync-cadence.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=b94d840968827dfe4a26ece06cc1a946)

> [!NOTE]
>
> The first scheduled sync sends the full cohort. Each later sync sends only users added or removed since the previous sync.

5. Click **Sync**.

## 4. Verify the cohort in Notifly

In the Notifly console, open **User Management** > **User Group** to find the synced cohort.

![Synced Amplitude cohort in the Notifly user group list](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/amplitude/notifly-user-group-amplitude.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=07f80abcf7443b729151d70dae0e43be)

Cohorts from Amplitude have the suffix `(Amplitude)`.

![Details of a user group synced from Amplitude](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/amplitude/notifly-user-group-amplitude-details.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=c6f118a9936db9690e8b1632544fb1ca)

> [!WARNING]
>
> Notifly adds only users whose mapped Amplitude ID matches an `external_user_id` in Notifly.
>
> For example, Cohort 1 contains users A, B, and C. If only A and C have matching `external_user_id` values in Notifly, the new user group contains only A and C.

## FAQ

> [accordion] Can I use cohort sync and event streaming together?
>
> Yes. You can set up and use event streaming and cohort sync independently.

> [accordion] Why does my user count differ from the count in Amplitude?
>
> Notifly adds only the users whose IDs match an `external_user_id` in Notifly. Check that you mapped the correct field from Amplitude.

> [accordion] How often should I sync a cohort?
>
> * To send a cart reminder soon after someone leaves items in their cart, choose the shortest interval your Amplitude plan and destination offer.
> * For campaigns that reach out to inactive users, a daily sync may be enough if your plan and destination offer it.
>
> Shorter intervals update the user group more often and may increase your Amplitude usage.

> [accordion] Can I sync multiple cohorts?
>
> Yes. Each Amplitude cohort appears as a separate Notifly user group.

> [accordion] Can I edit a synced user group manually?
>
> You can't edit a synced user group directly in Notifly. Edit the cohort in Amplitude and sync it again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.