Skip to main content

​
Create your Service Account

1

Open Project Settings

Go to your Mixpanel project, click the gear icon in the bottom-left, then select Project Settings.
2

Go to Service Accounts

In the Project Settings page, click the Service Accounts tab on the right side.
3

Create a new Service Account

Click Create Service Account.
4

Configure the account

  • Give it a name (e.g. “UserJourneys Export”)
  • Set the role to Analyst
5

Copy your credentials

Click Create. You’ll see a username and secret.
Copy both immediately — the secret won’t be shown again.
6

Paste into UserJourneys

Go back to UserJourneys, paste the username and secret into the Mixpanel connection form, and click Connect. UserJourneys detects your project automatically — no project ID or region to enter. If the service account can access more than one project, you’ll be asked to pick which one to connect.

​
Sync cohorts to UserJourneys

Cohort sync is optional and set up separately from connecting your account. It lets Mixpanel push cohort membership to UserJourneys for use in Study Launch Rules.
1

Generate the webhook secret

In the Mixpanel connection settings, expand Cohort sync (optional) and click Set up cohort sync. UserJourneys shows the webhook URL, the Basic Auth username, and a one-time secret.
Copy the secret immediately — it’s shown only once. If you lose it, use Regenerate secret; regenerating invalidates the previous secret until you update it in Mixpanel.
2

Create a webhook destination in Mixpanel

In Mixpanel, open the cohort sync/integrations area and create a custom webhook destination. Paste the UserJourneys webhook URL as the destination URL, enable Basic Auth, and paste the displayed username and secret.
3

Select cohorts to sync

For each Mixpanel cohort you want to use for Study Launch Rules, sync or export that cohort to the UserJourneys webhook destination.
4

Include identity properties

Include mixpanel_distinct_id. If your app user id differs from Mixpanel distinct id, also include that app user id as reference_id.
Saved cohorts can now appear as UserJourneys Audiences and can be connected to Studies through Study Launch Rules.