- Overview
- Setup Guide
- Permissions
- Troubleshooting
Connect Parable to Mixpanel for product analytics using HTTP Basic authentication with an organization service account. Parable syncs raw events, user profiles, cohorts, funnels, and optionally annotations and group profiles.
Events & people
Raw event export and People / Engage profilesDefinitions
Cohorts, funnel list, annotations| Field | Required | Notes |
|---|---|---|
| Service Account Username | Yes | Basic auth username |
| Service Account Secret | Yes | Basic auth password; shown once at creation |
| Project ID | Yes | Sent as project_id on Query and Export requests |
| Query base URL | No (defaults US) | Engage, cohorts, funnels, annotations |
| Export base URL | No (defaults US) | Raw event export only |
| Data Group ID | No | Required for group_profiles |
| Tap | Sync | Notes |
|---|---|---|
raw_events | Incremental date windows | Export API; JSONL; up to 30-day windows |
user_profiles | Incremental via $last_seen | Engage POST form body + session/page pagination |
cohorts | Full | Cohort list |
funnels_list | Full | Funnel definitions |
annotations | Full | Off by default |
group_profiles | Full | Off by default; needs Data Group ID |
Data streams
This Provider Plugin defines 6 data streams.| Stream | Description | Sync |
|---|---|---|
raw_events | Raw Mixpanel events as newline-delimited JSON from the Export API. Date-window incremental sync via from_date/to_date; each line is one tracked event with its full properties bag. | incremental |
user_profiles | Mixpanel People (user) profiles via the Engage API. Incremental by $last_seen using a where filter; session_id + page hybrid pagination. | incremental |
cohorts | Saved cohort definitions from Mixpanel. Full sync; the cohort list is small and has no incremental cursor. | full |
funnels_list | List of saved funnel definitions from Mixpanel. Full sync; enumerates funnels by id and name. | full |
annotations | Project annotations (notes attached to dates on Mixpanel charts). Full sync; opt-in. | full |
group_profiles | Mixpanel Group Analytics profiles via the Engage API with a data_group_id. Full sync; session_id + page hybrid pagination. Requires Group Analytics; opt-in. | full |
Mixpanel
What You’ll Need
| Credential | What it is |
|---|---|
| Service Account Username | Username from Mixpanel Organization Settings → Service Accounts |
| Service Account Secret | Secret shown once when the service account is created |
| Project ID | Numeric Mixpanel project ID |
| Query / Export base URLs | Regional hosts for your project’s data residency (defaults to US) |
| Data Group ID | Optional. Required only if syncing group profiles |
Info: Setup access in Mixpanel. These steps require Organization Owner or Admin, or a colleague with equivalent permissions who can create credentials for you. If that is not you, ask your Mixpanel administrator.
- Organization Owner or Admin to create service accounts
- Service account granted at least Analyst (or equivalent read) access on the target project
- Your project’s Project ID and data residency region (US, EU, or India)
Step 1: Create a service account
- Sign in to Mixpanel as an organization Owner or Admin.
- Open Organization Settings → Service Accounts (or go to mixpanel.com/settings/org#serviceaccounts).
- Click Create Service Account.
- Choose a name (for example
parable-sync) and grant the account access to the project(s) Parable should read. - Copy the Username and Secret.
Warning: Copy your Service Account Secret now! This is the only time it will be displayed. Store it in a secure password manager before closing this page.
Step 2: Find your Project ID and residency
- Open Organization Settings → Projects, or Project Settings for the active project.
- Copy the Project ID (numeric).
- Note Data Residency (US, EU, or India). Hosts must match residency:
| Region | Query base URL | Export base URL |
|---|---|---|
| US (default) | https://mixpanel.com/api/query | https://data.mixpanel.com |
| EU | https://eu.mixpanel.com/api/query | https://data-eu.mixpanel.com |
| India | https://in.mixpanel.com/api/query | https://data-in.mixpanel.com |
Step 3: Optional — Group Analytics data group ID
Only needed if you enable thegroup_profiles tap.- In Mixpanel, open Group Analytics settings for the project.
- Copy the data group ID for the group key you want to sync.
- Keep it for the Parable form’s Data Group ID field.
Step 4: Enter values in the form
- In Parable, open Platform → Providers and choose the Provider to add.
- Select Mixpanel.
- Enter Service Account Username, Service Account Secret, and Project ID.
- If not US residency, set Query base URL and Export base URL from the table above.
- (Optional) Enter Data Group ID for group profiles.
- Click Save & test connection.
Test Engage with Basic auth
read -rs -p "Service account username: " MP_USER && echo
read -rs -p "Service account secret: " MP_SECRET && echo
read -p "Project ID: " MP_PROJECT
read -p "Query base URL [https://mixpanel.com/api/query]: " MP_BASE
MP_BASE="${MP_BASE:-https://mixpanel.com/api/query}"
curl --silent --user "${MP_USER}:${MP_SECRET}" \
-X POST "${MP_BASE}/engage?project_id=${MP_PROJECT}" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data ""
unset MP_USER MP_SECRET MP_PROJECT MP_BASE
Success: Success! If you received a200 OKresponse with a JSON body containingresults(may be empty), your credentials are configured correctly. You can now configure this Provider in Parable.
Tip: Rate Limits: Mixpanel query/export quotas vary by plan. Parable is configured for about 0.5 requests/second and respects Retry-After.
Parable handles rate limiting automatically with exponential backoff, but initial syncs of large event windows may take longer.
Annotations
Annotations
Developer identifier:
annotationsAnnotations contain project annotations (notes attached to dates on Mixpanel charts). Full sync; opt-in.- Enables: place project notes on the dates to which Mixpanel attaches them.
- Scope: Reads the declared collection through
GET /annotationsas a full snapshot. Results are limited to the configured Mixpanel project and service-account access.
Date
Date
Developer identifier:
annotations.dateDate records the date the annotation is attached to. It anchors the named event or boundary on the record’s timeline.- Enables: place annotation records on a timeline by date and select the records within an explicit reporting window.
- Interpretation: The provider supplies
dateper mixpanel annotation record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
Description
Description
Developer identifier:
annotations.descriptionDescription records annotation text. It keeps the exact text, label, or authored value needed to interpret the record.- Enables: inspect the exact description value attached to each mixpanel annotation record.
- Interpretation: The provider supplies
descriptionat mixpanel annotation granularity in the format stated by its description; omitted or redacted content remains unknown.
ID
ID
Developer identifier:
annotations.idID is the unique annotation identifier. It supplies the declared record identity used when repeated ingestions represent the same source row.- Enables: recognize repeated ingestions of the same mixpanel annotation source row before constructing its represented state.
- Interpretation: The provider supplies
idat one value per mixpanel annotation record, andx-transformDedupKeyexplicitly marks it as the record key.
Project ID
Project ID
Developer identifier:
annotations.project_idProject ID identifies Mixpanel project ID the annotation belongs to. It is needed to resolve references that repeat the same provider identifier.- Enables: match annotation records to provider records that carry the same project ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
project_idas a record-level identifier onMixpanelAnnotation. It is not a uniqueness guarantee unless a connector directive says so.
Cohorts
Cohorts
Developer identifier:
cohortsCohorts contain saved cohort definitions from Mixpanel. Full sync; the cohort list is small and has no incremental cursor.- Enables: catalog saved cohort definitions for interpreting cohort references in Mixpanel.
- Scope: Reads the declared collection through
GET /cohorts/listas a full snapshot. Results are limited to the configured Mixpanel project and service-account access.
Count
Count
Developer identifier:
cohorts.countCount reports the number of users currently matching the cohort. It preserves the stated measure at this record’s granularity.- Enables: measure the provider-reported count for each mixpanel cohort record.
- Interpretation: The provider supplies
countat mixpanel cohort granularity as a count at one value per record; zero and missing are not interchangeable.
Created
Created
Developer identifier:
cohorts.createdCreated records the timestamp when the cohort was created. It anchors the named event or boundary on the record’s timeline.- Enables: place cohort records on a timeline by created and select the records within an explicit reporting window.
- Interpretation: The provider supplies
createdper mixpanel cohort record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
Data Group ID
Data Group ID
Developer identifier:
cohorts.data_group_idData Group ID identifies data group identifier when the cohort is a group cohort. It is needed to resolve references that repeat the same provider identifier.- Enables: match cohort records to provider records that carry the same data group ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
data_group_idas a record-level identifier onMixpanelCohort. It is not a uniqueness guarantee unless a connector directive says so.
Description
Description
Developer identifier:
cohorts.descriptionDescription records cohort description. It keeps the exact text, label, or authored value needed to interpret the record.- Enables: inspect the exact description value attached to each mixpanel cohort record.
- Interpretation: The provider supplies
descriptionat mixpanel cohort granularity in the format stated by its description; omitted or redacted content remains unknown.
ID
ID
Developer identifier:
cohorts.idID is the unique cohort identifier. It supplies the declared record identity used when repeated ingestions represent the same source row.- Enables: recognize repeated ingestions of the same mixpanel cohort source row before constructing its represented state.
- Interpretation: The provider supplies
idat one value per mixpanel cohort record, andx-transformDedupKeyexplicitly marks it as the record key.
Is Visible
Is Visible
Developer identifier:
cohorts.is_visibleIs Visible indicates whether the cohort appears in the Mixpanel UI. It preserves the provider’s integer-encoded visibility condition.- Enables: separate UI-visible cohorts from cohorts the provider marks as hidden.
- Interpretation: The provider supplies
is_visibleas an integer flag, not a quantity; preserve the provider encoding and keep zero distinct from missing.
Name
Name
Developer identifier:
cohorts.nameName records cohort name. It keeps the exact text, label, or authored value needed to interpret the record.- Enables: inspect the exact name value attached to each mixpanel cohort record.
- Interpretation: The provider supplies
nameat mixpanel cohort granularity in the format stated by its description; omitted or redacted content remains unknown.
Funnels List
Funnels List
Developer identifier:
funnels_listFunnels List contains the saved funnel definitions returned by Mixpanel.- Enables: resolve saved funnel identifiers to their Mixpanel names.
- Scope: Reads the declared collection through
GET /funnels/listas a full snapshot. Results are limited to the configured Mixpanel project and service-account access.
Funnel ID
Funnel ID
Developer identifier:
funnels_list.funnel_idFunnel ID is the unique funnel identifier. It supplies the declared record identity used when repeated ingestions represent the same source row.- Enables: recognize repeated ingestions of the same mixpanel funnel source row before constructing its represented state.
- Interpretation: The provider supplies
funnel_idat one value per mixpanel funnel record, andx-transformDedupKeyexplicitly marks it as the record key.
Name
Name
Developer identifier:
funnels_list.nameName records funnel name. It keeps the exact text, label, or authored value needed to interpret the record.- Enables: inspect the exact name value attached to each mixpanel funnel record.
- Interpretation: The provider supplies
nameat mixpanel funnel granularity in the format stated by its description; omitted or redacted content remains unknown.
Group Profiles
Group Profiles
Developer identifier:
group_profilesGroup Profiles contain the property map returned for each Mixpanel Group Analytics entity.- Enables: segment Group Analytics profiles by the provider-supplied group properties.
- Scope: Reads the declared collection through
POST /engageas a full snapshot. The operation requires Group Analytics and is opt-in; projects without that feature return no group profiles.
$distinct ID
$distinct ID
Developer identifier:
group_profiles.$distinct_id$distinct ID is the unique identifier of the group profile. It supplies the declared record identity used when repeated ingestions represent the same source row.- Enables: recognize repeated ingestions of the same mixpanel group profile source row before constructing its represented state.
- Interpretation: The provider supplies
$distinct_idat one value per mixpanel group profile record, andx-transformDedupKeyexplicitly marks it as the record key.
$group ID
$group ID
Developer identifier:
group_profiles.$group_id$group ID captures the group ID value. It is needed to resolve references that repeat the same provider identifier.- Enables: match group profile records to provider records that carry the same $group ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
$group_idas a record-level identifier onMixpanelGroupProfile. It is not a uniqueness guarantee unless a connector directive says so.
$group Key
$group Key
Developer identifier:
group_profiles.$group_key$group Key captures the group key (property) this group is keyed on. It is needed to resolve references that repeat the same provider identifier.- Enables: match group profile records to provider records that carry the same $group key, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
$group_keyas a record-level identifier onMixpanelGroupProfile. It is not a uniqueness guarantee unless a connector directive says so.
$properties
$properties
Developer identifier:
group_profiles.$properties$properties captures the group profile property bag. It retains configured attributes whose keys or shape are not fixed by this base schema.- Enables: interpret $properties according to the provider and Workspace configuration that produced each group profile record.
- Interpretation: Keys and value shapes within
$propertiescan vary with provider and customer configuration; consumers must inspect the observed Workspace schema rather than assume a fixed contract.
$last Seen
$last Seen
Developer identifier:
group_profiles.$properties.$last_seen$last Seen records the timestamp when the group was last seen. It anchors the named event or boundary on the record’s timeline.- Enables: place group profile records on a timeline by $last seen and select the records within an explicit reporting window.
- Interpretation: The provider supplies
$last_seenper mixpanel group profile property record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
Raw Events
Raw Events
Developer identifier:
raw_eventsRaw Events contain raw Mixpanel events as newline-delimited JSON from the Export API. Date-window incremental sync via from_date/to_date; each line is one tracked event with its full properties bag.- Enables: measure occurrences of tracked product events using each event’s timestamp, name, and property bag.
- Scope: Reads provider changes through
GET {exportBaseUrl}/api/2.0/exportusing the declared incremental request boundary. Results are limited to the configured Mixpanel project and service-account access.
Event
Event
Developer identifier:
raw_events.eventEvent captures the name of the tracked event. It keeps the exact text, label, or authored value needed to interpret the record.- Enables: inspect the exact event value attached to each mixpanel raw event record.
- Interpretation: The provider supplies
eventat mixpanel raw event granularity in the format stated by its description; omitted or redacted content remains unknown.
ID
ID
Developer identifier:
raw_events.idID identifies synthetic deduplication key hashed from $insert_id, time, event, distinct_id, and device_id. It supplies the declared record identity used when repeated ingestions represent the same source row.- Enables: recognize repeated ingestions of the same mixpanel raw event source row before constructing its represented state.
- Interpretation: Parable generates
idat one value per mixpanel raw event record, andx-transformDedupKeyexplicitly marks it as the record key.
Properties
Properties
Developer identifier:
raw_events.propertiesProperties captures the event property bag. It retains configured attributes whose keys or shape are not fixed by this base schema.- Enables: interpret properties according to the provider and Workspace configuration that produced each raw event record.
- Interpretation: Keys and value shapes within
propertiescan vary with provider and customer configuration; consumers must inspect the observed Workspace schema rather than assume a fixed contract.
$browser
$browser
Developer identifier:
raw_events.properties.$browser$browser records browser used when the event was sent. It preserves the client environment reported with the event.- Enables: count Mixpanel events by the reported $browser client environment.
- Interpretation: Mixpanel supplies
$browserper tracked event from client metadata; missing values do not identify an operating system or browser.
$city
$city
Developer identifier:
raw_events.properties.$city$city records city derived from IP geolocation at event time. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.- Enables: segment raw event records by the recorded $city without inferring a person’s physical presence.
- Interpretation: The provider supplies
$cityas location or localization context per mixpanel event property record; it does not establish a person’s real-time physical location.
$insert ID
$insert ID
Developer identifier:
raw_events.properties.$insert_id$insert ID is the unique ID assigned to the event. It is needed to resolve references that repeat the same provider identifier.- Enables: match raw event records to provider records that carry the same $insert ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
$insert_idas a record-level identifier onMixpanelEventProperties. It is not a uniqueness guarantee unless a connector directive says so.
$lib Version
$lib Version
Developer identifier:
raw_events.properties.$lib_version$lib Version records version of the Mixpanel SDK library used to send the event. It preserves the configuration or technical value needed to explain how the provider object is defined.- Enables: inspect the exact $lib version when validating the configuration or technical definition of a mixpanel event property record.
- Interpretation: The provider supplies
$lib_versionas configuration or technical metadata onMixpanelEventProperties; consumers must preserve the exact syntax and documented vocabulary.
$OS
$OS
Developer identifier:
raw_events.properties.$os$OS records operating system of the device that sent the event. It preserves the client environment reported with the event.- Enables: count Mixpanel events by the reported $OS client environment.
- Interpretation: Mixpanel supplies
$osper tracked event from client metadata; missing values do not identify an operating system or browser.
$user ID
$user ID
Developer identifier:
raw_events.properties.$user_id$user ID identifies identified user ID (post identity-merge), when present. It is needed to resolve references that repeat the same provider identifier.- Enables: match raw event records to provider records that carry the same $user ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
$user_idas a record-level identifier onMixpanelEventProperties. It is not a uniqueness guarantee unless a connector directive says so.
Device ID
Device ID
Developer identifier:
raw_events.properties.device_idDevice ID identifies device identifier when the event is not yet identified to a distinct_id. It is needed to resolve references that repeat the same provider identifier.- Enables: match raw event records to provider records that carry the same device ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
device_idas a record-level identifier onMixpanelEventProperties. It is not a uniqueness guarantee unless a connector directive says so.
Distinct ID
Distinct ID
Developer identifier:
raw_events.properties.distinct_idDistinct ID is the unique identifier of the user who triggered the event, when present. It is needed to resolve references that repeat the same provider identifier.- Enables: match raw event records to provider records that carry the same distinct ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
distinct_idas a record-level identifier onMixpanelEventProperties. It is not a uniqueness guarantee unless a connector directive says so.
Email
Developer identifier:
raw_events.properties.emailEmail records email property carried on the event, when present. It keeps the provider-reported person or account context attached to the record.- Enables: attribute the mixpanel event property record to the provider-reported person or account represented by email.
- Interpretation: The provider supplies
emailas identity or attribution context on each mixpanel event property record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
Mp Country Code
Mp Country Code
Developer identifier:
raw_events.properties.mp_country_codeMp Country Code records ISO 3166-1 alpha-2 country code derived from IP geolocation. It preserves the configuration or technical value needed to explain how the provider object is defined.- Enables: inspect the exact mp country code when validating the configuration or technical definition of a mixpanel event property record.
- Interpretation: The provider supplies
mp_country_codeas configuration or technical metadata onMixpanelEventProperties; consumers must preserve the exact syntax and documented vocabulary.
Project ID
Project ID
Developer identifier:
raw_events.properties.project_idProject ID identifies Mixpanel project ID the event belongs to. It is needed to resolve references that repeat the same provider identifier.- Enables: match raw event records to provider records that carry the same project ID, without assuming that this field alone makes every row unique.
- Interpretation: The provider supplies
project_idas a record-level identifier onMixpanelEventProperties. It is not a uniqueness guarantee unless a connector directive says so.
Time
Time
Developer identifier:
raw_events.properties.timeTime records the instant when the event occurred as a Unix timestamp in seconds. It anchors the raw event on the activity timeline.- Enables: order events chronologically and select activity within an explicit reporting window.
- Interpretation: The provider supplies
timeas seconds since the Unix epoch; it represents an instant, not an elapsed duration or interval.
User Email
User Email
Developer identifier:
raw_events.properties.user_emailUser Email records user email carried on the event, when present. It keeps the provider-reported person or account context attached to the record.- Enables: attribute the mixpanel event property record to the provider-reported actor represented by user email.
- Interpretation: The provider supplies
user_emailas identity or attribution context on each mixpanel event property record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
Time
Time
Developer identifier:
raw_events.timeTime records unix timestamp in seconds when the event occurred (mirrors properties.time; root-visible for promote ordering and quality event_time). It anchors the named event or boundary on the record’s timeline.- Enables: place raw event records on a timeline by time and select the records within an explicit reporting window.
- Interpretation: The provider supplies
timeper mixpanel raw event record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
User Profiles
User Profiles
Developer identifier:
user_profilesUser Profiles contain Mixpanel People (user) profiles via the Engage API. Incremental by $last_seen using a where filter; session_id + page hybrid pagination.- Enables: segment Mixpanel People profiles by provider-supplied profile attributes and last-seen time.
- Scope: Reads provider changes through
POST /engageusing the declared incremental request boundary. Results are limited to the configured Mixpanel project and service-account access.
$distinct ID
$distinct ID
Developer identifier:
user_profiles.$distinct_id$distinct ID is the unique identifier of the user profile. It supplies the declared record identity used when repeated ingestions represent the same source row.- Enables: recognize repeated ingestions of the same mixpanel user profile source row before constructing its represented state.
- Interpretation: The provider supplies
$distinct_idat one value per mixpanel user profile record, andx-transformDedupKeyexplicitly marks it as the record key.
$properties
$properties
Developer identifier:
user_profiles.$properties$properties captures the user profile property bag. It retains configured attributes whose keys or shape are not fixed by this base schema.- Enables: interpret $properties according to the provider and Workspace configuration that produced each user profile record.
- Interpretation: Keys and value shapes within
$propertiescan vary with provider and customer configuration; consumers must inspect the observed Workspace schema rather than assume a fixed contract.
$city
$city
Developer identifier:
user_profiles.$properties.$city$city records city derived from IP geolocation. It preserves the geographic, locale, time-zone, or coordinate context represented by the field.- Enables: segment user profile records by the recorded $city without inferring a person’s physical presence.
- Interpretation: The provider supplies
$cityas location or localization context per mixpanel user profile property record; it does not establish a person’s real-time physical location.
$country Code
$country Code
Developer identifier:
user_profiles.$properties.$country_code$country Code records ISO 3166-1 alpha-2 country code derived from IP geolocation. It preserves the configuration or technical value needed to explain how the provider object is defined.- Enables: inspect the exact $country code when validating the configuration or technical definition of a mixpanel user profile property record.
- Interpretation: The provider supplies
$country_codeas configuration or technical metadata onMixpanelUserProfileProperties; consumers must preserve the exact syntax and documented vocabulary.
$created
$created
Developer identifier:
user_profiles.$properties.$created$created records the timestamp when the profile was created. It anchors the named event or boundary on the record’s timeline.- Enables: place user profile records on a timeline by $created and select the records within an explicit reporting window.
- Interpretation: The provider supplies
$createdper mixpanel user profile property record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
$email
Developer identifier:
user_profiles.$properties.$email$email records user email address. It keeps the provider-reported person or account context attached to the record.- Enables: attribute the mixpanel user profile property record to the provider-reported person or account represented by $email.
- Interpretation: The provider supplies
$emailas identity or attribution context on each mixpanel user profile property record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
$first Name
$first Name
Developer identifier:
user_profiles.$properties.$first_name$first Name records user first name. It keeps the provider-reported person or account context attached to the record.- Enables: attribute the mixpanel user profile property record to the provider-reported person or account represented by $first name.
- Interpretation: The provider supplies
$first_nameas identity or attribution context on each mixpanel user profile property record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
$last Name
$last Name
Developer identifier:
user_profiles.$properties.$last_name$last Name records user last name. It keeps the provider-reported person or account context attached to the record.- Enables: attribute the mixpanel user profile property record to the provider-reported person or account represented by $last name.
- Interpretation: The provider supplies
$last_nameas identity or attribution context on each mixpanel user profile property record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
$last Seen
$last Seen
Developer identifier:
user_profiles.$properties.$last_seen$last Seen records the timestamp when the user was last seen. Incremental cursor. It anchors the named event or boundary on the record’s timeline.- Enables: place user profile records on a timeline by $last seen and select the records within an explicit reporting window.
- Interpretation: The provider supplies
$last_seenper mixpanel user profile property record as a timestamp at the precision returned by the provider; missing values mean the event or boundary was not reported.
$phone
$phone
Developer identifier:
user_profiles.$properties.$phone$phone records user phone number. It keeps the provider-reported person or account context attached to the record.- Enables: attribute the mixpanel user profile property record to the provider-reported person or account represented by $phone.
- Interpretation: The provider supplies
$phoneas identity or attribution context on each mixpanel user profile property record. Names and contact values can change and are not stable identifiers unless the provider documents them as such.
| Error | Meaning | Solution |
|---|---|---|
401 Unauthorized | Bad username or secret | Recreate the service account; secret is shown once |
403 Forbidden | No access to the project | Grant the service account a project role with read access |
400 Bad Request | Bad Project ID or params | Confirm Project ID and regional hosts match residency |
Empty raw_events | No events in the date window | Widen the sync window or confirm the project has events |
group_profiles skipped / empty | Missing or wrong Data Group ID | Set Data Group ID; Group Analytics must be enabled |
Common Issues
Wrong region hosts
If Project ID is correct but requests fail or return empty, confirm Query and Export base URLs match the project’s data residency (US / EU / India).Service account cannot see the project
Creating the account at the org is not enough — grant it membership on the specific project with a read-capable role.Service Accounts — Roles and creationAuthentication — HTTP Basic auth with service accountsRaw Export API — Endpoint used byraw_eventsData residency — Regional Query and Export hosts