Mixpanel

The Userflow-Mixpanel integration connects Userflow’s in-app guidance data with Mixpanel’s product analytics platform. Once connected, you can stream Userflow events to Mixpanel, sync user attributes and events in both directions, and pull Mixpanel cohorts into Userflow as segments — so both tools see the same picture of how users engage with your product.

Key benefits

Bi-directional event and attribute sync. Mixpanel events and user attributes appear in Userflow segments, auto-start conditions, Chart Builder, and Funnel Analysis. Userflow user and group attributes sync back into Mixpanel for analysis alongside your existing data.

Automated event streaming. Critical Userflow events — such as when a user starts a flow or completes a checklist task — can be continuously sent to your chosen Mixpanel project for unified analytics.

Cohort sync. Mixpanel cohorts (groups of users defined by shared behaviors) can be synced back to Userflow as segments, so you can target and personalize in-app experiences for specific user groups.

Streamlined setup. Connecting Userflow and Mixpanel is a one-time setup per environment. We recommend starting with your Staging setup to confirm everything works before enabling the connection in Production.

With Userflow and Mixpanel connected, product teams can measure the impact of onboarding experiences, identify drop-off points, correlate feature usage with guided flows, and build more data-driven adoption and retention strategies.

What bi-directional sync means

Previously, the Mixpanel integration only supported sending events from Userflow to Mixpanel (event streaming) and pulling cohorts from Mixpanel into Userflow. Both of those still work — no changes are needed for existing setups. Bi-directional sync adds two more directions:

• Mixpanel → Userflow. Events and user attributes from Mixpanel become available in Userflow segments, auto-start conditions, Chart Builder charts, and Funnel Analysis.

• Userflow → Mixpanel (attributes). User and group attributes from Userflow sync into Mixpanel.

You can enable each direction independently. Existing Userflow → Mixpanel event streaming and Mixpanel Cohort Sync continue to work alongside the new options.

When to use bi-directional sync

Use bi-directional sync when:

• You already track key product events in Mixpanel and want to trigger Userflow flows from them without re-instrumenting.

• You want Userflow attribute data available in Mixpanel alongside your other product analytics.

• Your team is split — analytics in Mixpanel, in-app guidance in Userflow — and you want both tools to see the same picture.

Prerequisites

• A Userflow account with Owner or Admin role.

• A Mixpanel project, including:

  • Service account credentials (username and secret) — only required if you want to receive data from Mixpanel into Userflow.

  • The Mixpanel project token — required for any direction.

• Plan availability — available on all plans.

Mixpanel projects and Userflow environments

Best practice: Use separate projects for each environment.

We recommend using separate Mixpanel projects for each environment (e.g., Production and Staging) to prevent data contamination. Since each Userflow-Mixpanel integration connects one Userflow environment to one Mixpanel project, you'll need to set up the integration separately for each environment.

Best practice: Start with a staging environment or project first.

We strongly recommend setting up and testing the integration in your staging environment before connecting it to production. This allows you to verify that everything works correctly without affecting your live data. If you have both staging and production environments, you'll need to complete the setup process twice — once for each environment.

Required user ID match for integration

Use consistent user IDs. For accurate data correlation, you must use the same user ID to identify users in both Userflow and Mixpanel.

Connect Mixpanel to Userflow

1. In Userflow, go to Settings > Integrations.

2. Click Add integration and select Mixpanel.

3. Click Connect with Mixpanel.

4. Choose which direction(s) you want to enable:

   • Receive data from Mixpanel into Userflow — imports attributes and events from Mixpanel.

   • Send data from Userflow to Mixpanel — sends attributes from Userflow into Mixpanel. (Existing event streaming is configured separately and is not affected by this toggle.)

   You can enable one or both. Each direction has its own input requirements (see below).

5. Click Next, enter the inputs for your chosen direction(s), and click Save.

Inputs required by direction

Where to find each value in Mixpanel

• Server region — In Mixpanel, go to Project settings > Data residency. Select the matching region in Userflow (e.g., United States).

• Service account username and secret — In Mixpanel, go to Org settings > Service accounts. If you don't have a service account, create one. Copy the username and secret immediately — Mixpanel does not display the secret again after creation. If you lose the secret, you'll need to create a new service account.

• Project timezone — In Mixpanel, go to Settings > Project settings > Overview. Copy the timezone string (for example, Asia/Kolkata or America/Los_Angeles).

• Project ID — In Mixpanel, go to Settings > Project settings > Overview. Copy the project ID.

• Project token — In Mixpanel, go to Settings > Project settings > Access keys. The token is shown as the API key.

After entering the inputs, click Save. The integration card updates to show Connected, and you can reconnect or disconnect at any time.

Map attributes (object mapping)

Object mapping is how Mixpanel fields connect to Userflow fields. Set this up after the connection is live.

1. In the Mixpanel integration page, click Select object type and choose User or Group.

2. Click Continue.

3. Pick a Mixpanel field to sync and choose a data type.

4. Either map it to an existing Userflow field, or let Userflow create a new field automatically if no match exists.

5. To set up both user and group mappings, click Continue again after saving the first and configure the second.

   • For Group mapping, you'll also need to provide a group key and data group ID.

6. Click Save mapping. Mapped fields start syncing in both directions.

Set up Mixpanel event sync to Userflow

Event sync brings Mixpanel events into Userflow as events you can use in segments, auto-start conditions, and analytics.

1. In the Mixpanel integration page, toggle Mixpanel event sync on.

2. Select the Mixpanel events you want to import from the dropdown.

   • If you have no Mixpanel events yet, the only option will be Create new event — create your events in Mixpanel first, then return here.

3. If your Mixpanel project is a legacy project, check the legacy project checkbox. (Mixpanel-side configuration determines this; if you're not sure, leave it unchecked and contact Mixpanel support to confirm your project type.)

4. Click Save.

Imported Mixpanel events appear in Userflow within a few minutes.

Set up Userflow event streaming to Mixpanel

1. Sign in to Mixpanel and navigate to the project you want to stream Userflow events to.
   
   

2. Open Project Settings for the relevant project.
   
   

3. Copy the Project Token from the Access Keys section.
   
   

4. Log in to Userflow and navigate to the environment you want to stream Userflow events from.
   

5. Select Settings > Integrations from the sidebar. Then click Add integration.
   

6. Select Mixpanel.
   

7. Click Add Mixpanel.
   

8. Paste the Token you copied from Mixpanel in step 3 above into the Mixpanel Token field and enter the name of the user ID property you share with user profiles in Mixpanel in the Mixpanel User ID Property field. For example, user_id, then click Save.
   

9. Use the toggle switch to activate the option to Stream events from Userflow to Mixpanel and click Save. Confirm the selection when prompted. Event streaming will start immediately.
   

Verify event streaming

1. Select Data > Events.
   
   

2. Verify that Userflow events appear as expected.
   

Stopping event streaming

1. In Userflow, select Settings > Integrations and open your Mixpanel integration.

2. Use the toggle switch to deactivate Stream events from Userflow to Mixpanel. Event streaming will stop immediately.
   

Set up Mixpanel cohort sync to Userflow

This configuration automatically syncs user cohorts from Mixpanel to Userflow segments.

Note

Mixpanel refers to user groups as "cohorts," whereas Userflow refers to them as "segments."

Step 1: Configure Mixpanel-Userflow event streaming

Set up the Mixpanel integration in Userflow as directed in the Set up Userflow event streaming to Mixpanel section above.

Step 2: Configure User ID in Userflow

1. In Userflow, select Settings > Integrations > Mixpanel.
   

2. Complete the Mixpanel User ID Property under Mixpanel settings.

   1. Enter the user property in Mixpanel where you store users’ IDs.

      Example: Type user_id if your Mixpanel snippet calls something like mixpanel.people.set({user_id: id}), and this id is the same value your Userflow.js snippet passes to userflow.identify(id).
      

      If you’re not using a dedicated user ID property in Mixpanel, you may enter mixpanel_distinct_id into this field, but note that this will use whatever canonical Distinct ID Mixpanel chooses for your user profiles, which may not always be the same value you pass to mixpanel.identify(id) if you have Mixpanel’s Identity Merge feature enabled.
      

3. Click Save.

4. Copy the Webhook URL to your clipboard.
   

5. Continue in Mixpanel using the instructions below.

Step 3: Complete configuration in Mixpanel

1. In Mixpanel, select Settings > Integrations from the lower left corner.

2. Scroll down the page and select Custom Webhook.

3. Click Connect under Custom Webhook. If you already have other custom webhooks, select Add Connection from the menu dropdown.
   

4. Enter “Userflow” as the Connector Name and paste the Webhook URL you copied from Userflow in the URL field.
   

5. Select Lexicon from the left-hand navigation, then select Cohorts.
   

6. Select Cohorts from the Saved Definitions section.

7. Click the three-dot button next to the cohort you want to sync to Userflow. (Scroll to the right if the three dots are not visible.)

8. Hover over Export to…, then click Custom Webhook (Userflow).
   

9. Choose whether you want to do a one-time export or a recurring sync.

10. Click Begin sync.

11. Once Mixpanel starts syncing (which should happen within a few minutes), you’ll be able to see the cohort as a segment on your Users page in Userflow.

Using Mixpanel data in Userflow

Once Mixpanel events and attributes are imported, they're available across Userflow exactly like any native Userflow event or attribute:

• Segments. Build segments based on Mixpanel events ("Users who triggered feature_x_used in the last 7 days") or Mixpanel attributes.

• Auto-start conditions. Trigger a flow when a user fires a specific Mixpanel event or has a specific Mixpanel attribute value.

• Chart Builder. Visualize Mixpanel event trends alongside in-app engagement data.

• Funnel Analysis. Use Mixpanel events as funnel steps.

You no longer need to create a Mixpanel cohort and sync it just to use Mixpanel data in Userflow.

Using Userflow data in Mixpanel

Userflow attributes (and event streaming, if you've configured it) sync into Mixpanel and can be used in your Mixpanel dashboards, cohorts, and analyses alongside Mixpanel-native data.

Logs

After the integration is connected, the Logs tab shows event streaming and sync activity. Use it to confirm data is moving and troubleshoot delivery issues.

Troubleshooting

Mixpanel events aren't appearing in Userflow segments.

• Confirm the Mixpanel event sync toggle is on and the event is selected in your sync list.

• Check the Logs tab for ingestion errors.

• Verify the Mixpanel event name matches exactly — Mixpanel event names are case-sensitive.

• New imports can take a few minutes to appear; allow time before troubleshooting further.

Userflow attributes aren't appearing in Mixpanel.

• Confirm Object Mapping is configured for User (or Group, as applicable).

• Verify the service account credentials still have write access to the Mixpanel project. (Service account secrets are only viewable at creation — if you've lost the secret, create a new service account and reconnect.)

The connection shows as disconnected.

• Service account credentials may have rotated. Reconnect with new credentials.

• The Mixpanel project token may have changed. Update it in the integration settings.

My Mixpanel project type is unclear (legacy vs. non-legacy).

• This determines whether the legacy project checkbox in event sync should be on. If you're not sure, contact Mixpanel support — it's a Mixpanel-side property.