Skip to main content

Mixpanel

Connect Mixpanel to Catalog to bring dashboards, reports, and event-oriented metadata into your Workspace. You can use Catalog-managed credentials or prepare uploads yourself using the BI Importer format. Catalog-managed Mixpanel sync is still maturing alongside client-side tooling, so this page focuses on what you can configure today and how Mixpanel objects translate into Catalog.

Requirements​

You need to be a Mixpanel Project owner or Admin to create the credentials Catalog uses for Mixpanel.

Catalog Managed​

Use this section when Catalog stores your Mixpanel credentials and runs scheduled sync for your Workspace.

Integration in progress

Catalog-managed Mixpanel onboarding is still maturing. Treat this path as the supported way to hand credentials to Catalog for scheduled sync when your Workspace is enabled for it. If you need a fully self-run pipeline today, use Client Managed with BI Importer instead.

To connect Mixpanel with Catalog-managed credentials, supply a Mixpanel service account. Enter the following JSON in Catalog:

{
    "username": "<service account username>",
    "password": "<service account password>"
}

For instructions on creating service accounts, see Mixpanel service accounts documentation.

You can enter credentials directly in Catalog.

For your first sync, allow up to 48 hours. Catalog notifies you when the initial sync completes.

If you prefer not to share credentials with Catalog operations, continue to Client Managed.

Client Managed​

Doing a One-Time Extract​

For a trial or one-time view of Mixpanel content in Catalog, extract or assemble Mixpanel metadata into BI Importer expected format, then upload it using the path your Catalog contact provides.

The Catalog extractor package published on PyPI includes dedicated command-line entry points for several BI platforms. There is not yet a published castor-extract-mixpanel command in that package. Until a Mixpanel-specific command ships, rely on BI Importer formatting and upload flows rather than a named extractor CLI. You can still use the shared Google Colab notebook to experiment with extraction patterns for other supported tools while you shape Mixpanel files by hand or with your own scripts.

Mixpanel to Catalog Translation​

Use this mapping when you structure BI Importer files or interpret synced objects:

  • Event - Catalog visualization model
  • Report - Tile
  • Dashboard - Dashboard

Additional Mixpanel objects surface in Catalog only when your payload or connector ingestion includes them.

Scheduling and Upload After Trial​

When you move beyond a one-time upload, Catalog typically provides a Catalog identifier and token so you can push files with castor-upload on a schedule you control. Align scheduling and upload steps with your Catalog contact so uploads stay aligned with your Mixpanel estate.

Common Issues​

  • Credentials rejected - Confirm the service account is active, has access to the Mixpanel projects you expect, and matches the JSON field names Catalog expects for Mixpanel.
  • Sparse dashboards or reports - Catalog reflects the metadata Mixpanel exposes for the account and projects you connected. Narrow project or workspace scope in Mixpanel can limit what appears in Catalog.

What's Next?​

  • Browse related setup patterns on BI Tools.
  • Review file layout and columns for uploads in BI Importer.