Mixpanel connection

Deprecation notice — Project Secret authentication

Mixpanel has deprecated Project Secret (API key) authentication. After March 3, 2027, all API calls using Project Secret will stop working.

New connections must use Service Account credentials. Existing connections using an API key will break on the deadline if not migrated. Refer to Migrating existing connections for steps.

Prerequisites

Service Account credentials (recommended)

Mixpanel Service Accounts replace Project Secret authentication and provide granular, per-project permission controls.

Creating a Mixpanel Service Account

1. Log in to your Mixpanel account.
2. Go to Organization Settings → Service Accounts.
3. Click Add Service Account.
4. Enter a name and assign the required role (for example, Analyst for read-only data extraction).
5. Select the projects this Service Account can access.
6. Click Create. Mixpanel displays the Service Account Username and Service Account Secret — copy these immediately, as the secret is not shown again.

Project Secret (deprecated)

warning

Project Secret authentication is deprecated and will stop working after March 3, 2027. Use Service Account credentials for all new connections.

Retrieving the Project Secret

1. Log in to your Mixpanel account.
2. Click on your username in the top right corner of the page.
3. Go to Project Settings.
4. Copy the Project Secret from the details section.

Creating a connection

Using service account credentials

1. Navigate to the Data Integration console and select Connections.
2. Click + Create New Connection.
3. Choose Mixpanel.
4. Enter the Connection Name.
5. Enter the Service Account Username.
6. Enter the Service Account Secret.
7. If your Mixpanel account uses the EU subdomain, select the EU Subdomain option. You can confirm this by checking the URL of your Mixpanel account settings page.
8. Click Test connection to verify the credentials.
9. Click Save.

Using project secret (deprecated)

1. Navigate to the Data Integration console and select Connections.
2. Click + Create New Connection.
3. Choose Mixpanel.
4. Enter the Connection Name.
5. Enter the API Secret.
6. If your Mixpanel account relates to the EU subdomain, select the EU Subdomain option. You can confirm this by examining the URL of your account settings page in the Mixpanel.
7. Click Test connection to ensure the validity of the API key.
8. Click Save.

Migrating existing connections

If you have existing rivers using Project Secret authentication, migrate them to Service Account credentials before March 3, 2027 to avoid disruption.

1. Create a Mixpanel Service Account and note the Service Account Username and Service Account Secret (refer to Prerequisites).
2. Open your existing Mixpanel connection in Data Integration.
3. Replace the API key field with the Service Account Username and Service Account Secret.
4. Click Test connection to confirm the new credentials work.
5. Click Save.

Your existing rivers continue to run without changes to their configuration, but only connection credentials change.