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:

  • Authorization: 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.