> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mixpanel

> How to set up the Mixpanel connector, plus the actions and events that are available.

![Mixpanel](https://stackone-logos.com/api/mixpanel/filled/svg)

v3.0.0[See changelog](https://docs.stackone.com/connectors/mixpanel/changelog.md)

[54 actions](#actions) · [4 events](#events) · 2 auth methods

Analytics
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Service Account · Connector Profile](https://docs.stackone.com/connectors/mixpanel/guides/connector-profile/service-account.md)
>
> Service Account authentication using HTTP Basic Auth for Mixpanel API access.

> [card] [Project Token · Connector Profile](https://docs.stackone.com/connectors/mixpanel/guides/connector-profile/project-token.md)
>
> Write-only credential for the Ingestion API — sending events, and creating or updating user and group profiles. Unlike a...

Optionally, configure receiving Events for Mixpanel into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/mixpanel/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Service Account · Link Account](https://docs.stackone.com/connectors/mixpanel/guides/link-account/service-account.md)

> [card] [Project Token · Link Account](https://docs.stackone.com/connectors/mixpanel/guides/link-account/project-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Project Token

Service Account

No auth methods found

54 actions

ActionDescription

List Annotations`mixpanel_list_annotations`

Retrieve all annotations within a date range for the Mixpanel project via GET /api/app/projects/\{projectId}/annotations....

Get Annotation`mixpanel_get_annotation`

Retrieve a single annotation by its numeric ID via GET /api/app/projects/\{projectId}/annotations/\{annotationId}. Returns...

Create Annotation`mixpanel_create_annotation`

Create a new annotation via POST /api/app/projects/\{projectId}/annotations to mark a significant event on Mixpanel chart...

Patch Annotation`mixpanel_patch_annotation`

Partially update an existing annotation via PATCH /api/app/projects/\{projectId}/annotations/\{annotationId}. Supports mod...

Delete Annotation`mixpanel_delete_annotation`

Permanently delete an annotation from the project via DELETE /api/app/projects/\{projectId}/annotations/\{annotationId}. T...

List Annotation Tags`mixpanel_list_annotation_tags`

Retrieve all annotation tags defined in the project via GET /api/app/projects/\{projectId}/annotations/tags. Tags are reu...

Create Annotation Tag`mixpanel_create_annotation_tag`

Create a new reusable annotation tag via POST /api/app/projects/\{projectId}/annotations/tags. Tags can then be attached...

List Cohorts`mixpanel_list_cohorts`

Retrieve all saved cohorts in the Mixpanel project via POST /api/query/cohorts/list. Returns cohort metadata including I...

Query Cohort Members`mixpanel_query_cohort_members`

Retrieve user profiles belonging to a specific cohort via the Engage API (POST /api/query/engage) using filter\_by\_cohort...

Import Events`mixpanel_import_events`

Bulk-import historical or server-side events into Mixpanel via POST /import, supporting up to 2000 events per batch (10M...

Export Events`mixpanel_export_events`

Export raw event data from Mixpanel via GET /api/2.0/export for a specified date range, returned as newline-delimited JS...

Set Group Properties`mixpanel_set_group_properties`

Set properties on a group profile (e.g. accounts, companies, workspaces) via POST /groups with the \$set operation. Creat...

Delete Group`mixpanel_delete_group`

Permanently delete a group profile and all stored properties from Mixpanel via POST /groups with the \$delete operation....

Set Group Properties Once`mixpanel_set_group_properties_once`

Set properties on a group profile via POST /groups with the \$set\_once operation, only writing values for properties that...

Union To Group List Property`mixpanel_union_group_list_property`

Add unique values to a list property on a group profile via POST /groups with the \$union operation; existing list items...

Remove From Group List Property`mixpanel_remove_group_list_property`

Remove specific values from list properties on a group profile via POST /groups with the \$remove operation. Silently ski...

Unset Group Properties`mixpanel_unset_group_properties`

Permanently remove specified property keys and their values from a group profile via POST /groups with the \$unset operat...

Get Unified Credentials`mixpanel_unified_get_me`

Return the authenticated identity, auth type, and connection metadata for the current Mixpanel Service Account, mapped t...

List Unified Groups`mixpanel_unified_list_groups`

List all teams in the Mixpanel organization mapped to the IAM unified group schema. Each team includes its stable id and...

Get Unified Group`mixpanel_unified_get_group`

Retrieve a single Mixpanel team by numeric id, mapped to the IAM unified group schema. Team members are exposed via unif...

List Unified Organizations`mixpanel_unified_list_organizations`

Returns the single Mixpanel organization that the Service Account is bound to. Synthesized from credentials.orgId — the...

Get Unified Organization`mixpanel_unified_get_organization`

Retrieve the single Mixpanel organization the Service Account is bound to. The id must match credentials.orgId; any othe...

List Unified Resource Types`mixpanel_unified_list_resource_types`

List the resource types Mixpanel supports for resource-scoped IAM queries. Mixpanel exposes "team" — teams expose member...

List Unified Resource Users`mixpanel_unified_list_resource_users`

List the members of a specific Mixpanel team (resource\_type=team), with each member carrying a resource-scoped IamRole p...

List Unified Roles`mixpanel_unified_list_roles`

Return the three workspace-level IAM roles for Mixpanel (owner, admin, member) synthesized from Mixpanel's organization...

Get Unified Role`mixpanel_unified_get_role`

Retrieve a single synthesized Mixpanel IAM role by its stable key (owner, admin, or member). The role namespace is close...

List Unified Users`mixpanel_unified_list_users`

List all users in the Mixpanel organization mapped to the IAM unified user schema. Pass expand=\["roles"] and/or expand=...

Get Unified User`mixpanel_unified_get_user`

Retrieve a single Mixpanel organization user by numeric id, mapped to the IAM unified user schema. Pass expand="roles"...

Create Identity`mixpanel_create_identity`

Link an anonymous user ID to a known user ID via the \$identify event on POST /track for identity resolution. This operat...

Merge Identities`mixpanel_merge_identities`

Merge two distinct\_ids into a single identity cluster via the \$merge event on POST /import. This operation is irreversib...

Create Alias`mixpanel_create_alias`

Create an alias linking one distinct\_id to another via the \$create\_alias event on POST /track. Only compatible with Orig...

List Lookup Tables`mixpanel_list_lookup_tables`

Retrieve all lookup tables in the Mixpanel project via GET /lookup-tables. Lookup tables map property values to addition...

Replace Lookup Table`mixpanel_replace_lookup_table`

Replace all data in an existing lookup table via PUT /lookup-tables/\{lookupTableId} with new CSV-formatted content. The...

Query User Profiles`mixpanel_query_profiles`

Query user profiles from the Mixpanel Engage API using filters, cohort membership, behavioral selectors, or specific dis...

Set User Profile Properties`mixpanel_set_profile_properties`

Set properties on a user profile via POST /engage with the \$set operation, creating the profile if it does not exist and...

Set User Profile Properties Once`mixpanel_set_profile_properties_once`

Set properties on a user profile via POST /engage with the \$set\_once operation, only writing values for properties that...

Increment User Profile Properties`mixpanel_increment_profile_properties`

Atomically increment or decrement numeric properties on a user profile via POST /engage with the \$add operation. Use pos...

Delete User Profile`mixpanel_delete_profile`

Permanently delete a user profile and all stored properties from Mixpanel via POST /engage with the \$delete operation. T...

Union To List Property`mixpanel_union_profile_list_property`

Add unique values to a list property on a user profile via POST /engage with the \$union operation; existing list items a...

Append To List Property`mixpanel_append_profile_list_property`

Append values to list properties on a user profile via POST /engage with the \$append operation, allowing duplicates unli...

Remove From List Property`mixpanel_remove_profile_list_property`

Remove specific values from list properties on a user profile via POST /engage with the \$remove operation. Silently skip...

Delete Profile Properties`mixpanel_unset_profile_properties`

Permanently remove specified properties and their values from a user profile via POST /engage with the \$unset operation....

Query Insights`mixpanel_query_insights`

Query a saved Insights report by bookmark ID via GET /api/query/insights, returning the computed time-series data for th...

Query Funnels`mixpanel_query_funnels`

Query a saved Funnel report by funnel ID via GET /api/query/funnels, returning step-by-step conversion data for the spec...

Query Retention`mixpanel_query_retention`

Query retention data via GET /api/query/retention, returning cohort-based retention metrics for a date range. Supports b...

Query JQL`mixpanel_query_jql`

Execute custom JQL (JavaScript Query Language) scripts against Mixpanel data via POST /api/query/jql. JQL is in maintena...

List Schemas`mixpanel_list_schemas`

Retrieve all data dictionary schemas (event and profile definitions) in the Mixpanel project via GET /api/app/projects/\{...

List Schemas For Entity`mixpanel_list_schemas_by_entity`

Retrieve schemas filtered by entity type ("event" or "profile") via GET /api/app/projects/\{projectId}/schemas/\{entityTyp...

List Schema By Entity And Name`mixpanel_list_schema_by_entity_and_name`

Retrieve the schema definition for a specific entity by type and name via GET /api/app/projects/\{projectId}/schemas/\{ent...

Create/Replace Multiple Schemas`mixpanel_create_replace_schemas`

Bulk upload or replace data dictionary schemas via POST /api/app/projects/\{projectId}/schemas. Existing schemas for spec...

Create/Replace One Schema`mixpanel_create_replace_schema`

Upload or replace the schema for a single entity via POST /api/app/projects/\{projectId}/schemas/\{entityType}/\{name}. Ove...

Delete All Schemas`mixpanel_delete_all_schemas`

Permanently delete all data dictionary schemas in the project via DELETE /api/app/projects/\{projectId}/schemas. This cle...

Delete Schemas For Entity`mixpanel_delete_schemas_by_entity`

Delete schemas by entity type via DELETE /api/app/projects/\{projectId}/schemas/\{entityType}. Optionally narrow deletion...

Delete Schema`mixpanel_delete_schema`

Delete the schema definition for a specific entity by type and name via DELETE /api/app/projects/\{projectId}/schemas/\{en...

## Events

Tags

Select all
|
Clear

Alerts

Cohorts

Webhooks

No tags found

4 events

EventDescriptionTags

Custom Alert Triggered`mixpanel_webhook_custom_alert_triggered`Manual setup

Fires when a Mixpanel Custom Alert triggers on an Insights or Funnels report (threshold breached, or an anomaly detected...

WebhooksAlerts

Cohort Full Sync`mixpanel_webhook_cohort_members`Manual setup

Fires when Mixpanel sends the full membership of a cohort to a custom webhook destination (Mixpanel `action` value \`memb...

WebhooksCohorts

Cohort Members Added`mixpanel_webhook_cohort_add_members`Manual setup

Fires when Mixpanel sends an incremental diff of users who have entered a cohort since the last sync (Mixpanel `action`...

WebhooksCohorts

Cohort Members Removed`mixpanel_webhook_cohort_remove_members`Manual setup

Fires when Mixpanel sends an incremental diff of users who have exited a cohort since the last sync (Mixpanel `action` v...

WebhooksCohorts


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.