Mixpanel integration

UserGist sends core events through Mixpanel's server-side Import API. Choose US, EU, or India to match the project residency.

Required identity mode

Version 1 supports Simplified ID Merge only. In Mixpanel, open Project Settings → Identity Merge and confirm Simplified ID Merge is enabled before connecting.

Connect

  1. Copy the project token from Mixpanel project settings.
  2. Open UserGist → App settings → Integrations → Mixpanel.
  3. Select the matching region and event categories, then connect.
  4. Find UserGist Integration Connected in the Events Activity Feed using the synthetic device ID shown by UserGist.

Identity mapping

UserGistMixpanel
anonymousId$device_id
externalId$user_id
Event identitydistinct_id is the external ID when identified, otherwise the anonymous ID
Event UUID$insert_id

Use the same immutable account ID in UserGist.identify() that your existing Mixpanel implementation uses as $user_id. Do not substitute email unless email is genuinely immutable in your system.

Mixpanel Import API documentation · Simplified ID Merge