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

# Mixpanel

> Connect Mixpanel to pull product analytics events into your workflows.

## How to set up Mixpanel

### Authentication

Mixpanel requires service account credentials:

1. Log in to your Mixpanel account

2. Navigate to **Settings** → **Project Settings** → **Service Accounts**

3. Create a new service account or use an existing one

4. Gather the following credentials:
   * **Username**: Service account username
   * **Secret Key**: Service account secret
   * **Project ID**: Your Mixpanel project ID (found in Project Settings)

5. Enter these credentials in Cargo when connecting

## Mixpanel data models

### Fetch events

Pull product analytics events from Mixpanel into Cargo.

**Configuration:**

* **From date**: Start date for fetching events

**Features:**

* **Incremental sync**: Only fetches new events since the last sync
* **Minimum interval**: 12 hours between syncs

**Use cases:**

* Trigger workflows based on product usage patterns
* Identify highly engaged users for sales outreach
* Build lead scoring models using product analytics
* Create segments based on feature adoption

## Event data

Mixpanel events typically include:

| Field        | Description             |
| ------------ | ----------------------- |
| event        | Event name              |
| distinct\_id | User identifier         |
| time         | Event timestamp         |
| properties   | Custom event properties |

## Best practices

* Use consistent `distinct_id` values that map to your CRM contacts
* Define key activation and engagement events in Mixpanel
* Set appropriate sync intervals based on your workflow needs
* Combine Mixpanel data with enrichment data for complete lead profiles