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

# External Cohorts

> Sync your Amplitude and/or Mixpanel cohorts with Reforge Insights to understand qualitative feedback from specific groups.

# Overview

The cohorts integration with Amplitude and Mixpanel are a great way to get product insights from specific cohorts that you've defined externally. With these integrations, your team can:

* Surface trends from cohorts
* Extract common feature requests, bug reports, and questions
* Understand what specific groups of people are asking about

# Supported Sources

<AccordionGroup>
  <Accordion title="Amplitude">
    You can find the Amplitude integration on your integration settings page under *External Cohort Sources*. A user with access to both Reforge Insights as well as Amplitude will need to authorize the connection.

    **Reforge Insights Setup**

    <Steps>
      <Step>
        Go to the Reforge Insights [integrations page](https://insights.reforge.com/w/default/settings/integrations). Ensure you have the correct workspace selected.
      </Step>

      <Step>
        Scroll down to the **External Cohort Sources** section and click **Connect** in the Amplitude Cohorts panel.
      </Step>

      <Step>
        Click **Connect Amplitude** and copy the API key. Note that once you navigate away from this page, the API key is no longer viewable.
      </Step>
    </Steps>

    **Amplitude Setup**

    <Steps>
      <Step>
        In Amplitude Data, click **Catalog** and select the **Destinations** tab.
      </Step>

      <Step>
        Filter by Type: Cohorts, and click on the **Reforge** destination. Then click on **Add another destination.**
      </Step>

      <Step>
        Enter a name for the integration and the API key you copied during the Reforge Insights setup.
      </Step>

      <Step>
        Under **User Mapping**, select an Amplitude user property to use for mapping users. This user property must be an email address field.
      </Step>

      <Step>
        When finished, click **Save**.
      </Step>

      <Step>
        Follow these steps to sync any of your Amplitude cohorts to your Insights Analytics destination:

        1. From the Syncs page in Amplitude (found under the **Users** menu), click on **Create Sync**.
        2. Select **Cohort** as the sync type, then select a cohort from the dropdown menu that appears. Click **Next**.
        3. Select **Reforge** from the *or sync this cohort to...* section. Select the Reforge integration you set up previously in the dropdown menu and click **Next**.
        4. Set the sync cadence, then click **Sync** to start syncing.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Mixpanel">
    You can find the Mixpanel integration on your integration settings page under *External Cohort Sources*. A user with access to both Reforge Insights as well as Mixpanel will need to authorize the connection.

    **Reforge Insights Setup**

    <Steps>
      <Step>
        Go to the Reforge Insights [integrations page](https://insights.reforge.com/w/default/settings/integrations). Ensure you have the correct workspace selected.
      </Step>

      <Step>
        Scroll down to the **External Cohort Sources** section and click **Connect** in the Mixpanel Cohorts panel.
      </Step>

      <Step>
        Click **Connect Mixpanel**. You'll see a url, username and password. Once you navigate away from this page, these items are no longer viewable so note them somewhere.
      </Step>
    </Steps>

    **Mixpanel Setup**

    <Steps>
      <Step>
        In Mixpanel, click the Setting icon at the bottom-left of the srcreen and then Integrations.
      </Step>

      <Step>
        Click the Custom Webhooks section in the Integrations pane.
      </Step>

      <Step>
        In the setup modal, add a connector name and enter the url, username and password that you noted from step 5 above. Click continue.
      </Step>

      <Step>
        Follow these steps to sync any of your Mixpanel cohorts to Insights Analyytics:

        1. From the Cohorts page in Mixpanel, hover over the *Export to...* option from the dots menu of the cohort you want to sync and click on the connector name from step 3 above.
        2. Select the export type - *One-time export* or *Recurring sync* and then click *Begin Sync*. Your sync will be queued.
        3. To view the status of your sync at any time, click on the dots menu of the cohort again. After a sync has completed, if you reload the Insights Analytics Mixpanel integration page, you'll see the synced cohort.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>