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

# Mixpanel source

> Connect Mixpanel to Chartcastr for automated DAU/WAU/MAU, top events, funnels, retention, and custom event overlays delivered to Slack or email.

## Overview

Use Mixpanel as a data source for Chartcastr. Connect your project with a **Service Account** and Chartcastr will pull active user metrics, top events, saved funnels, cohort retention, and a custom multi-event overlay to generate charts delivered automatically to Slack or email.

Chartcastr connects with read-only access to your Mixpanel project — the Service Account only needs the **Analyst** role.

<Warning>
  **Mixpanel Query API requires a paid Mixpanel plan.** Free / Starter projects can't make API calls and will fail at connect time with `402: Your plan does not allow API calls`. You need at least a paid Mixpanel tier (Growth or Enterprise) to use Mixpanel as a Chartcastr source. See [Mixpanel pricing](https://mixpanel.com/pricing).
</Warning>

## Setup

<Steps>
  <Step title="Create a Mixpanel Service Account">
    In Mixpanel, go to **Project Settings → Service Accounts** and create a new account. Grant it the **Analyst** role on the project. Copy the **username** and **secret** — you'll need both.

    <Warning>
      Service Account creation requires Owner or Admin permission on the Mixpanel project. The legacy "API Secret" still works but is being phased out — prefer Service Accounts.
    </Warning>
  </Step>

  <Step title="Find your Project ID">
    Your numeric Project ID is in your Mixpanel URL: `https://mixpanel.com/project/<PROJECT_ID>/...` (or `eu.mixpanel.com` for EU residency).
  </Step>

  <Step title="Connect in Chartcastr">
    In Chartcastr, go to **New Connection** and select **Mixpanel** as a source. Pick **US** or **EU** region, paste the Service Account username + secret + Project ID, and click **Test & Connect**.

    <Frame>
      <img src="https://mintcdn.com/chartcastr/gH3iqzjWqGqz43EW/images/integrations/sources/mixpanel/connect-mixpanel.png?fit=max&auto=format&n=gH3iqzjWqGqz43EW&q=85&s=f4f037d62145958f4467751a36b9b495" alt="Chartcastr Connect Mixpanel modal with US/EU region toggle, Service Account username and secret fields, and Project ID field" width="591" height="494" data-path="images/integrations/sources/mixpanel/connect-mixpanel.png" />
    </Frame>

    <Info>
      **Region**: Use **US** for `mixpanel.com` or **EU** for `eu.mixpanel.com`. The region drives which Query API host we hit and is locked once connected — disconnect and reconnect to switch regions.
    </Info>
  </Step>

  <Step title="Confirm your pageview event">
    After connecting, Chartcastr auto-detects your pageview event by looking for common names (`Page Viewed`, `$mp_web_page_view`, `Page View`, etc.) in your top events. You can override it with any event from your project — pick **Pick a different event** in the connect modal.
  </Step>

  <Step title="Select a metric">
    Choose a chart type. Funnel metrics ask you to pick a saved funnel; the Custom Events Overlay asks you to pick up to 5 events.
  </Step>

  <Step title="Create a connection">
    Pick or add a destination (Slack channel or email), set the delivery frequency, and optionally enable AI summaries.
  </Step>
</Steps>

## Available Metrics

Chartcastr supports **12 pre-built Mixpanel metrics** across six categories.

<CardGroup cols={2}>
  <Card title="Active Users" icon="users">
    DAU, WAU, MAU, and a combined DAU/WAU/MAU chart for engagement tracking.
  </Card>

  <Card title="Events" icon="bolt">
    Total events, unique event users, and a stacked Top Events chart.
  </Card>

  <Card title="Pageviews" icon="eye">
    Total pageviews and unique pageview users using your auto-detected pageview event.
  </Card>

  <Card title="Funnels" icon="filter">
    Saved-funnel conversion rate over time and per-step user counts.
  </Card>

  <Card title="Retention" icon="repeat">
    Average weekly cohort retention curve.
  </Card>

  <Card title="Custom Events Overlay" icon="layers">
    Pick up to 5 events and overlay them as lines on a single chart.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/mixpanel/available-charts">
  See the full list of Mixpanel metrics with chart types and descriptions.
</Card>

## Authentication

Chartcastr uses HTTP Basic auth with your Service Account username and secret. The secret is encrypted at rest with AES-256-GCM. We never store the project token — only the SA credentials, which are read-only.

## Rate Limits

Mixpanel's Query API is capped at **60 queries/hour** per project with a maximum of **5 concurrent queries**. Chartcastr's pulse cadence (daily/weekly) keeps you well below the cap. If you hit the limit you'll see a clear "rate limit hit" error in the chart preview — wait an hour and try again.

## Custom Events Overlay

The **Custom Events Overlay** chart lets you pick up to 5 event names from your project and renders them as a multi-line chart on a single shared Y axis with a fixed color palette.

<Note>
  v1 ships with a single shared Y axis. Per-event left/right axis selection is on the v2 roadmap so high-volume and low-volume events can share a chart without one squashing the other.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver Mixpanel charts to your Slack channels with AI summaries in the thread.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Schedule Mixpanel reports to any inbox or distribution list.
  </Card>
</CardGroup>