> For the complete documentation index, see [llms.txt](https://ask.birdie.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/amplitude-cohort-sync.md).

# Amplitude (Cohort Sync)

### Overview

The Amplitude integration for Birdie is a push connector that processes webhook requests from an Amplitude Cohorts integration. It works by receiving incremental cohort sync updates from Amplitude. Birdie stores and consolidates this information into a single record, allowing you to use your cohorts as filters within Birdie.

### Requirements

* A paid Amplitude plan
* At least one cohort configured in your Amplitude account (you can configure multiple cohorts, and Birdie will consolidate them at the user level)
* An active Birdie account and your Organization ID (<https://app.birdie.ai/settings/organization>)
* A Birdie Token to configure the integration (contact us and we will provide one)
* A field that can be matched to your feedbacks within Birdie. It's important for your cohort exports to contain at least one field (account\_id) that also exists within the Birdie feedbacks so we can match them.

### Setup in Amplitude with Destination Webhook

#### Open Amplitude Home

1. On the Amplitude Home, go to the Products tab and select **Sync Cohort**
2. In the Products tab, select Syncs and then click **Create Sync**

#### Create New Sync

1. Select the cohort you want to sync and click Next
2. On the next page, in the **Sync this cohort to...** section, click **Add or Manage Destinations**
3. Click **Add Destination** and select **Webhook - Cohorts**

#### Configure Webhook Destination

In the configuration page, fill in the following fields:

* **Display Name:** The name displayed in your destinations list
* **Webhook URL:** <https://api.birdie.ai/ingestion/amplitude/cohorts>
* **Headers:** Add the following authentication header:
  * **Authentication:** Basic "Token" (Provided by us)
* **Number of users per batch:** The default is 10,000 users, but this can be adjusted. Amplitude recommends batches of up to 10,000 users per cohort sync.
* **Payload:** Define the payload to send in the webhook request. We recommend using the default Amplitude payload, which follows the Amplitude cohort format. If you need to use a custom payload, contact our team so we can adjust the integration.

When finished, click Save.

### Connect to Birdie

After configuring the Custom Webhook Integration, Amplitude will automatically send cohort updates to the Birdie ingestion endpoint using the Organization ID and API Key provided by Birdie. No additional action is required after the initial setup.

### Data in scope

This connector receives incremental cohort updates from Amplitude for the cohorts you configure to sync. The data is stored in Birdie and can be used as filters alongside your other datasets.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/amplitude-cohort-sync.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.