# Integrating Amplitude

{% hint style="info" %}
Note: To integrate Amplitude, the **Amplitude project you're using must be on a paid plan**.
{% endhint %}

You can perform various tasks in FlareLane that target Amplitude cohorts.

Once the integration with Amplitude is complete, devices that match the user\_id within the Amplitude cohort will be grouped into a separate segment.

## How to Start

Step 1. In the Amplitude console, go to **Data > Catalog > Destinations > Webhook**.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2Fzb8NtqouOR5aslyCAylC%2FSfcr8LN_wJG4qICsB5cbb_amplitude-catalog-destinations-pipeline.webp?alt=media&#x26;token=96047176-6d59-49cb-ab1a-c127104b6a18" alt=""><figcaption><p>Image by FlareLane</p></figcaption></figure>

Step 2. In the **Destinations**, enter the following values in the **Webhook URL** and **Headers** fields, respectively. Select the other options appropriately as needed.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2Fpoistaw9PjilhLtPTaVE%2F4.Create_Intergration_step_4.png?alt=media&#x26;token=43deb434-1219-468b-a8f9-fe90896ef145" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="285">Category</th><th>Input</th></tr></thead><tbody><tr><td>Webhook URL</td><td>http://api.flarelane.com/v1/cohort-sync/amplitude</td></tr><tr><td>Headers (x-flarelane-project-id)</td><td>The ID of the FlareLane project you want to integrate</td></tr><tr><td>Headers (x-flarelane-api-key)</td><td>The API key of the integrated FlareLane project</td></tr></tbody></table>

***

## Integrating Cohorts

Once the integration is complete, you can link the Amplitude cohort to FlareLane following the steps below:

Step 1. In the Amplitude console, click **Audiences > Syncs > Create Sync**

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2FdPMjjRDiBj8VjINXq986%2FrCI6yquda5qpWIqCqTUKh_amplitude-syncs-create.webp?alt=media&#x26;token=8bd825cb-5ad8-4f26-a08d-acd5a9503070" alt=""><figcaption><p><em>Image by FlareLane</em></p></figcaption></figure>

Step 2. Select the cohort to link, then click **Next**.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2FoQFTr0dFtu09rUQslKzx%2F2DvTy6u0cbz59QqDP1YJM_amplitude-cohort-select.webp?alt=media&#x26;token=d82715c1-f34c-4f0c-9455-6e55607649bb" alt=""><figcaption><p><em>Image by FlareLane</em></p></figcaption></figure>

Step 3. Select **All Traffic > Webhook** as the Destination.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2FUBPd7mCawNQNsE0OKEQo%2FW5mCkv-WxeHQFAHp454gj_amplitude-cohort-destination.webp?alt=media&#x26;token=36fead3f-7921-4648-a310-5df7383fe90d" alt=""><figcaption><p><em>Image by FlareLane</em></p></figcaption></figure>

Step 4. Select the **FlareLane integration** that was created earlier.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2F2QCV3B5qrPXi4lmCZquA%2F2EGZQxbyU_8V5-uqwd-UG_amplitude-cohort-select-webhook.webp?alt=media&#x26;token=d7678230-3bc3-477c-a88b-981e40fe5abb" alt=""><figcaption><p><em>Image by FlareLane</em></p></figcaption></figure>

Step 5. Select the **sync type**. For Scheduled Sync, the following conditions apply depending on the type:

{% hint style="info" %}

* **Hourly Sync** can sync up to 1 million users.
* **Daily Sync** can sync up to 10 million users.
  {% endhint %}

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2FxanVfvNPxPsN8ROxYfMJ%2Fif8npKI1FTqGGxKZ30XHh_amplitude-define-cadence.webp?alt=media&#x26;token=0c87c633-8ef9-4a3a-af4d-0218cd3939db" alt=""><figcaption><p><em>Image by FlareLane</em></p></figcaption></figure>

Step 6. Once the sync begins, a separate segment with an Amplitude badge will be automatically created in **FlareLane segments** as follows:

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2F57JEs5ZlQGuRCCV3Grmv%2Fs-8XKt7O4yyqgqQCqImRt_screenshot-2024-04-24-at-112605-pm.jpg?alt=media&#x26;token=b7bca9c4-360e-44fc-bfe8-6d78216e1dad" alt=""><figcaption><p><em>Image by FlareLane</em></p></figcaption></figure>

***

## Troubleshooting

### Manually Re-Syncing Cohorts

If the Amplitude cohort doesn't seem to be properly synced with FlareLane, you can attempt a manual re-sync. Here's how:

Step 1. In the Amplitude console, hover over the cohort in **Audiences > Syncs** and click **History**.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2FhQaqIBnwDrxzP6CLPteH%2F20PbvJnHB_38S230Y6p3S_amplitude-sync-history-button.webp?alt=media&#x26;token=4e8d53f5-c0ca-4bad-9e6f-13a09da590d0" alt=""><figcaption><p>Image by FlareLane</p></figcaption></figure>

Step 2. Click the **Sync** button on the cohort details page.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2FjsWNmIKaM2VDWmeK2hFk%2Fy0Rohz1XK6Zd5-vDiq84v_webhook-sync-button.webp?alt=media&#x26;token=5b27000b-291a-452a-b62f-629c2575057b" alt=""><figcaption><p><em>Image by FlareLane</em></p></figcaption></figure>

Step 3. In the pop-up, click **Sync Now** to start the re-sync process.

<figure><img src="https://4151189289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSJ35x4PFzaneH3SrvcBt%2Fuploads%2F2iQGLyDz5kdOs3koBSgV%2FhzkVHFeHi9y6X6eIcmTwz_2024-04-23-41500.webp?alt=media&#x26;token=61ad0343-6c51-4d82-82c0-8faba39bdeee" alt=""><figcaption><p>Image by FlareLane</p></figcaption></figure>