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

# Mixpanel

> Connect your Mixpanel project to Modus so your scopes have rich context about your product analytics.

Connect a Mixpanel project to Modus so your event and user schema becomes context that
Modus can reason over. Modus reads your project's event and profile
schema (Lexicon) — read-only — and stores your credentials encrypted in AWS
Secrets Manager.

## Prerequisites

Before you begin, make sure you have:

* A **Mixpanel project** and its **Project ID**.
* Its **data residency** region — United States (US) or European Union (EU).
* A **service account** with read access to the project (see below).

## Set up a service account

Modus authenticates with a Mixpanel **service account**.

<Steps>
  <Step title="Create the service account">
    In Mixpanel, open **Organization Settings → Service Accounts** and create a
    new service account with a role that can **read the project** (for example,
    Analyst or Consumer). Grant it access to the project you want to connect.
  </Step>

  <Step title="Copy the username and secret">
    Mixpanel shows the **service account username** and **secret** once. Copy both
    now — you'll paste them into Modus.
  </Step>

  <Step title="Find your Project ID and region">
    Open **Project Settings**. Copy the **Project ID**, and note whether the
    project is hosted in the **US** or **EU**.
  </Step>
</Steps>

## Connect in Modus

<Steps>
  <Step title="Open the Mixpanel connection form">
    1. Log into [Modus](https://app.getmodus.com).
    2. Click **Integrations** in the left sidebar.
    3. Find the **Mixpanel** card under **Analytics** and click **Connect**.
  </Step>

  <Step title="Fill in the connection details">
    Complete the form using the [field reference](#connection-form-field-reference)
    below. Make sure **Data Residency** matches your project's region.
  </Step>

  <Step title="Test and save">
    1. Click **Test Connection** to verify Modus can read your project schema.
    2. Click **Save Connection**.
  </Step>
</Steps>

## Connection form field reference

| Field                        | Description                         | Example                           |
| ---------------------------- | ----------------------------------- | --------------------------------- |
| **Connection Name**          | A friendly name for this connection | `Production Analytics`            |
| **Project ID**               | Your Mixpanel project ID            | `12345678`                        |
| **Data Residency**           | The region hosting your project     | `United States (US)`              |
| **Service Account Username** | The service account's username      | `modus.abc123.mp-service-account` |
| **Service Account Secret**   | The service account's secret        | *(your secret)*                   |

## Troubleshooting

| Symptom                         | Likely cause                                                      |
| ------------------------------- | ----------------------------------------------------------------- |
| **Authentication failed (401)** | The service account username or secret is wrong.                  |
| **Access denied (403)**         | The service account doesn't have access to this project.          |
| **Project not found**           | Wrong Project ID, or the **Data Residency** region doesn't match. |

## Verification

Your Mixpanel project is now connected. Modus turns your event and profile schema
into context so Modus can answer product-analytics questions accurately.

Need help? Contact us at [support@getmodus.com](mailto:support@getmodus.com).

<Note>
  Modus connects read-only and requests only the minimum access needed to
  understand your data. All credentials are encrypted and stored in AWS Secrets
  Manager — your secret is never stored in plaintext.
</Note>