Skip to content
Last updated

Mixpanel integration

Mixpanel is a product analytics platform for tracking user events, building funnels, and running cohort queries. The Mixpanel integration with Frontegg lets your application ingest events, update user and group profiles, run queries and reports, and export raw data on behalf of your users.


Prerequisites

  • A Mixpanel account with Organization Owner or Organization Admin permissions — required to create a Service Account
  • At least one Mixpanel project in your organization
  • Knowledge of your project's data residency region (US, EU, or India) — this determines which regional hosts the connector targets

Service Accounts only

Mixpanel does not expose OAuth 2.0 for third-party applications. The Frontegg connector authenticates with a Service Account using HTTP Basic auth — username and secret generated from your Mixpanel organization. The Project Token is also required because Mixpanel's legacy ingestion endpoints (/track, /engage, /groups) embed the token inside each payload object.

Create a Service Account

Step 1: Open Service Accounts in organization settings

In Mixpanel, open the settings gear in the left sidebar and go to Organization Settings → Service Accounts, or navigate directly to mixpanel.com/settings/org/service-accounts. Click + Add Service Account in the top-right corner.

Mixpanel Service Accounts page with Add Service Account button highlighted

Step 2: Configure the Service Account

In the Create Service Account dialog:

  • Name: Frontegg-Integration (the name must contain only letters, numbers, dashes, and underscores — no spaces)
  • Organization Role: Member — scopes the account to the projects you grant below
  • Projects: open the dropdown and select the project(s) you want the connector to access
  • Project Role: Admin — required if the connector needs to both query and ingest events. Pick Analyst for read-only access, or Consumer for the narrowest permissions. See Mixpanel roles and permissions for the full matrix.
  • Expires: Never — or set an expiration if required by your security policy

Click Create.

Create Service Account dialog with name, project, and role filled in

Step 3: Copy the username and secret

After clicking Create, Mixpanel displays the Service Account Username and Secret once. Copy both values immediately — the secret will never be shown again.

  • Username → paste into the Frontegg Service Account Username field
  • Secret → paste into the Frontegg API Key field

Save the secret now

Mixpanel does not let you retrieve the secret after closing this dialog. If you lose it, delete the Service Account and create a new one.

Service Account credentials dialog with username visible and secret blurred

Find your Project ID and Project Token

Step 4: Open Project settings

Click the settings gear in the left sidebar and go to Project Settings → Overview. Under Project Details you will see the Project ID (a numeric value) and the Data Residency (US, EU, or India).

  • Project ID → paste into the Frontegg Project ID field
  • Data Residency → map to the Frontegg Data residency region field: us, eu, or in (lowercase). If omitted, the connector defaults to us.

Project settings Overview with Project ID and Data Residency highlighted

Step 5: Copy the Project Token

Scroll down to the Access Keys section on the same page. Copy the Project Token — a 32-character hex string.

  • Project Token → paste into the Frontegg Project Token field

The Project Token is required for the legacy /track, /engage, and /groups ingestion endpoints, which embed the token inside each request payload.

Project settings Access Keys section with Project Token highlighted

Configure the Frontegg portal

Once you have collected all five values from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Mixpanel.
  2. Paste the Service Account Secret into the API Key field.
  3. Paste the Service Account Username into the Service Account Username field.
  4. Paste your Project ID into the Project ID field.
  5. Paste your Project Token into the Project Token field.
  6. Enter the Data residency region (us, eu, or in). Leave empty to default to us.
  7. Click Save.

Keep your credentials secure

Never share or commit your Service Account secret or Project Token to version control. Rotate the Service Account from Organization Settings → Service Accounts if you suspect it has been leaked.

Additional resources