Mixpanel
Send events and profile updates to Mixpanel for product analytics. Sync your warehouse data to track events and update user profiles in Mixpanel.
Prerequisites
- A Mixpanel account
- Your Mixpanel Project Token and API Secret
Authentication
Mixpanel uses Project Token + API Secret authentication.
- In Mixpanel, go to Settings > Project Settings
- Copy the Project Token and API Secret
- Enter both values in SignalSmith
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Data Residency | Select | Yes | Mixpanel data residency: United States or European Union. Default: US |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Event Type | Select | Yes | Type of data to send: Track Events or Profile Updates (People) |
Supported Operations
Sync Modes: Upsert, Insert
Audience Sync Modes: Add, Upsert
Features
- Field Mapping: Yes
- Schema Introspection: No
Required Mapping Fields
| Event Type | Required Fields |
|---|---|
| Track Events | distinct_id, event, time |
| Profile Updates | distinct_id |
Default Destination Fields
Track Events: distinct_id, event, time, ip, properties
Profile Updates: $distinct_id, $first_name, $last_name, $email, $phone, $city, $country_code
Troubleshooting
Events not appearing in reports
Mixpanel processes events in near real-time. If events are not appearing, verify the Project Token and ensure the distinct_id and event fields are correctly mapped.
Wrong data residency
US and EU data residencies are separate. Ensure you selected the correct region for your Mixpanel project.
Profile properties not prefixed
Mixpanel reserved profile properties use the $ prefix (e.g., $email, $first_name). Custom properties should not use this prefix.