> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mixpanel

> Mixpanel is a product analytics platform tracking user interactions and engagement, providing cohort analysis, funnels, and A/B testing to improve user experiences

![Mixpanel logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mixpanel.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=b976736569e3626cb3234b44cd7acd08)

* **Category:** analytics
* **Auth:** BASIC
* **Composio-managed OAuth available?** N/A
* **Tools:** 53
* **Triggers:** 0
* **Slug:** `MIXPANEL`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Service Accounts To Projects
>
> **Slug:** `MIXPANEL_ADD_SERVICE_ACCOUNTS_TO_PROJECTS`
>
> Add existing service accounts to projects in an organization, assigning the specified role in each project to every listed account. Requires a service account with organization admin or owner access.
>
> #### Input Parameters
>
> **projects** `array` *required*
>
> Projects and roles to assign to every listed service account.
>
> **organization\_id** `integer` *required*
>
> Organization containing the service accounts and projects.
>
> **service\_account\_ids** `array` *required*
>
> IDs of existing service accounts to add to the projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Unique Values to Profile List Property
>
> **Slug:** `MIXPANEL_ADD_UNIQUE_TO_PROFILE_LIST_PROPERTY`
>
> Tool to add unique values to list properties on user profiles in Mixpanel using the \$union operation. Use when you need to add items to list-type properties without creating duplicates. Unlike \$append, \$union ensures values are unique in the list. If the property doesn't exist, it creates a new list with the provided values.
>
> #### Input Parameters
>
> **ip** `integer`
>
> Controls geolocation. Set to 0 to disable geolocation, 1 to enable. Default is 1.
>
> **data** `array` *required*
>
> A list of profile update objects. Each object must contain \$token, \$distinct\_id, and \$union properties. The \$union operation adds values to list properties without creating duplicates.
>
> **strict** `integer`
>
> Enables validation with per-record error messages. Set to 1 to enable strict mode, 0 to disable. When enabled, returns detailed validation errors for each failed record.
>
> **verbose** `integer`
>
> Returns detailed response object. Set to 1 to get JSON response with status and error fields, 0 for plain text status (1 for success, 0 for failure). Default is 0.
>
> **callback** `string`
>
> JSONP callback function name. Used for JSONP requests.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Aggregated Event Property Values
>
> **Slug:** `MIXPANEL_AGGREGATED_EVENT_PROPERTY_VALUES`
>
> Get unique, total, or average data for a single event and property over days, weeks, or months. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the property you would like to get data for
>
> **type** `string ("general" | "unique" | "average")` *required*
>
> The analysis type you would like to get data for
>
> **unit** `string ("minute" | "hour" | "day" | "week" | "month")` *required*
>
> The level of granularity of the data
>
> **event** `string` *required*
>
> The event that you wish to get data for. Note: this is a single event name, not an array
>
> **limit** `integer`
>
> The maximum number of values to return
>
> **format** `string ("json" | "csv")`
>
> Data format options for Mixpanel responses.
>
> **values** `array`
>
> The specific property values that you would like to get data for. Example: \['female', 'unknown']
>
> **to\_date** `string`
>
> The date in yyyy-mm-dd format to query to (inclusive)
>
> **interval** `integer`
>
> The number of units to return data for. Specify either interval or from\_date and to\_date
>
> **from\_date** `string`
>
> The date in yyyy-mm-dd format to begin querying from (inclusive)
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Aggregate Event Counts (Deprecated)
>
> **Slug:** `MIXPANEL_AGGREGATE_EVENT_COUNTS`
>
> DEPRECATED: Use MIXPANEL\_AGGREGATE\_EVENTS instead. Tool to get unique, total, or average data for events over N days, weeks, or months. Use when analyzing event trends and patterns over time with different aggregation methods.
>
> #### Input Parameters
>
> **type** `string ("general" | "unique" | "average")` *required*
>
> Analysis type - determines the aggregation method for event data Valid values: 'general', 'unique', 'average', 'sum'. Any other value fails validation.
>
> **unit** `string ("minute" | "hour" | "day" | "week" | "month")` *required*
>
> Time granularity for data aggregation - determines how data points are grouped
>
> **event** `string` *required*
>
> The event or events to get data for, encoded as a JSON array string (e.g., '\["Event1", "Event2"]')
>
> **format** `string ("json" | "csv")`
>
> Data format options for Mixpanel responses.
>
> **to\_date** `string`
>
> End date in format YYYY-MM-DD (inclusive) - filters events up to and including this date
>
> **interval** `integer`
>
> Number of time units to return data for - limits the number of data points returned
>
> **from\_date** `string`
>
> Start date in format YYYY-MM-DD (inclusive) - filters events from this date onwards Strongly recommended; omitting both from\_date and to\_date may cause missing parameter errors.
>
> **project\_id** `integer` *required*
>
> Project identifier for authentication and project selection
>
> **workspace\_id** `integer`
>
> Workspace identifier if applicable - used for workspace-level queries
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Aggregate Events
>
> **Slug:** `MIXPANEL_AGGREGATE_EVENTS`
>
> Get aggregate event counts over time. Supports different types of aggregation: general, unique, average, sum.
>
> #### Input Parameters
>
> **type** `string ("general" | "unique" | "average" | "sum")`
>
> Type of aggregation
>
> **unit** `string ("minute" | "hour" | "day" | "week" | "month")`
>
> Time unit for grouping results
>
> **event** `string`
>
> Name of the event to analyze At least one of `event` or `events` must be provided per request; omitting both returns a 'Missing required parameter: event' error.
>
> **limit** `integer`
>
> Maximum number of results to return
>
> **where** `string`
>
> Expression to filter events
>
> **events** `array`
>
> List of event names to analyze
>
> **to\_date** `string` *required*
>
> End date for the query (inclusive)
>
> **interval** `integer`
>
> Time interval for the results in seconds
>
> **from\_date** `string` *required*
>
> Start date for the query (inclusive)
>
> **project\_id** `integer` *required*
>
> The ID of the project to query
>
> **workspace\_id** `integer`
>
> The ID of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive Experiment
>
> **Slug:** `MIXPANEL_ARCHIVE_EXPERIMENT`
>
> Archive an experiment in a Mixpanel workspace. Requires a service account with access to the workspace. Returns the provider's result, which may be an empty object on success. The optional empty request body is omitted.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment to archive.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to archive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel Data Deletion
>
> **Slug:** `MIXPANEL_CANCEL_DATA_DELETION`
>
> Cancel a GDPR or CCPA data deletion task that is still in progress. Uses the task's tracking ID, project token, and the connected account's regional application API. A successful cancellation normally returns no content. Requires the provider's documented OAuth bearer authentication for GDPR endpoints.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Project token for the deletion job.
>
> **tracking\_id** `string` *required*
>
> Task ID returned when the data deletion job was created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Saved Cohorts
>
> **Slug:** `MIXPANEL_COHORTS_LIST`
>
> Tool to list all saved cohorts in a Mixpanel project. Use when you need to retrieve cohort metadata including name, id, count, description, creation date, and visibility. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> The ID of the project to query. Required for listing cohorts.
>
> **workspace\_id** `integer`
>
> The ID of the workspace if applicable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Annotation
>
> **Slug:** `MIXPANEL_CREATE_ANNOTATION`
>
> Create an annotation marking a point in time on a Mixpanel project's charts. Optionally supply its date, description, and existing tag IDs. Requires a role of at least Analyst. Returns the annotation and its creator and tag details.
>
> #### Input Parameters
>
> **date** `string`
>
> Annotation date in "YYYY-MM-DD HH:mm:ss" format.
>
> **tags** `array`
>
> IDs of existing tags to add to the annotation.
>
> **project\_id** `integer` *required*
>
> Project ID in which to create the annotation.
>
> **description** `string`
>
> Text shown when looking at the annotation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Annotation Tag
>
> **Slug:** `MIXPANEL_CREATE_ANNOTATION_TAG`
>
> Tool to create a new annotation tag in Mixpanel using the provided name. Use when you need to create tags for organizing and categorizing annotations. Requires a role of at least Analyst.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the annotation tag to create
>
> **project\_id** `string` *required*
>
> The project identifier where the annotation tag will be created
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Data Deletion
>
> **Slug:** `MIXPANEL_CREATE_DATA_DELETION`
>
> Create a GDPR or CCPA deletion task for users in a Mixpanel project. Supply the project token and distinct IDs; optionally choose the compliance regime. Schedules deletion of user data and returns a task ID for checking status, rather than waiting for the deletion to complete. The provider documents OAuth bearer authentication for this API, not BASIC service-account authentication.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Project token sent as the token query parameter.
>
> **distinct\_ids** `array`
>
> Distinct IDs of users whose data should be deleted.
>
> **compliance\_type** `string ("CCPA" | "GDPR")`
>
> Compliance regime: CCPA or GDPR. Defaults to GDPR at the provider.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Data Retrieval
>
> **Slug:** `MIXPANEL_CREATE_DATA_RETRIEVAL`
>
> Create a GDPR or CCPA data retrieval job for users in a Mixpanel project. Supply the project token and distinct IDs; optionally choose the compliance regime and CCPA disclosure type. Returns the task ID for checking job status, not the exported user data itself. The provider documents OAuth bearer authentication for GDPR endpoints; BASIC service-account authentication is not documented for this API.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Project token sent as the token query parameter.
>
> **distinct\_ids** `array`
>
> Distinct IDs of users whose data should be retrieved.
>
> **compliance\_type** `string ("CCPA" | "GDPR")`
>
> Compliance regime: CCPA or GDPR. Defaults to GDPR at the provider.
>
> **disclosure\_type** `string ("Data" | "Categories" | "Sources")`
>
> CCPA disclosure type: Data, Categories, or Sources. Only needed for CCPA; defaults to Data at the provider.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Event Stream Import
>
> **Slug:** `MIXPANEL_CREATE_EVENT_STREAM_IMPORT`
>
> Create a warehouse event-stream import that syncs table rows as Mixpanel events. Requires an existing warehouse source and a static event name or event-name column. For B2B projects provide company\_column\_name. Creation may initiate data ingestion.
>
> #### Input Parameters
>
> **run\_every** `integer ("0" | "3600000000000" | "86400000000000" | "604800000000000")`
>
> Sync interval in nanoseconds: 0 (API only), 3600000000000 (hourly), 86400000000000 (daily), or 604800000000000 (weekly).
>
> **sync\_mode** `string ("time_based" | "mirror_mode" | "full_sync" | "one_time")` *required*
>
> Incremental time\_based, mirror\_mode, full\_sync, or one\_time sync.
>
> **event\_name** `string`
>
> Static event name; provide this or event\_column\_name.
>
> **project\_id** `string` *required*
>
> Mixpanel project ID.
>
> **import\_type** `string` *required*
>
> Import type; must be event\_stream.
>
> **table\_params** `object` *required*
>
> Warehouse-specific table location object. Supports BigQuery, Snowflake, Redshift, Databricks, and PostgreSQL; keys depend on the source warehouse.
>
> **time\_column\_name** `string` *required*
>
> Column containing the event timestamp.
>
> **user\_column\_name** `string`
>
> Column containing the user identifier.
>
> **databricks\_params** `object`
>
> Databricks-specific export cluster settings, or null.
>
> **event\_column\_name** `string`
>
> Column containing event names; provide this or event\_name.
>
> **property\_mappings** `object`
>
> Property mapping string pairs, or null. Use insert\_id\_column\_name rather than mapping \$insert\_id.
>
> **device\_column\_name** `string`
>
> Device identifier column, or null.
>
> **company\_column\_name** `string`
>
> Company identifier column; required for B2B projects.
>
> **warehouse\_source\_id** `integer` *required*
>
> ID of the existing warehouse source.
>
> **insert\_id\_column\_name** `string`
>
> STRING column with unique event IDs for deduplication. Defaults to a row hash; mirror mode uses its row identifier by default.
>
> **insert\_time\_column\_name** `string`
>
> Insert timestamp column for incremental sync, or null.
>
> **json\_properties\_column\_name** `string`
>
> JSON event properties column, or null.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Experiment
>
> **Slug:** `MIXPANEL_CREATE_EXPERIMENT`
>
> Create an experiment in a Mixpanel workspace with a name and optional hypothesis, settings, variants, metrics, and visibility. Returns the created experiment. Requires a service account with access to the workspace.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Experiment name (1–255 characters).
>
> **metrics** `array`
>
> Experiment metrics. The API does not define an item schema.
>
> **settings** `object`
>
> Experiment settings, including feature flag settings. The API defines no fixed settings schema.
>
> **variants** `array`
>
> Experiment variants. The API does not define an item schema.
>
> **hypothesis** `string`
>
> Hypothesis being tested by the experiment.
>
> **description** `string`
>
> Experiment description (up to 400 characters).
>
> **workspace\_id** `integer` *required*
>
> Workspace in which to create the experiment.
>
> **global\_access\_type** `string`
>
> Global access type for the experiment; the API does not enumerate values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Feature Flag
>
> **Slug:** `MIXPANEL_CREATE_FEATURE_FLAG`
>
> Create a feature flag with variants and rollout rules in a project workspace. Uses Mixpanel's regional application API and service-account authentication. Returns the complete provider response for the created flag.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Feature flag creation payload.
>
> **project\_id** `integer` *required*
>
> Project ID in the URL path.
>
> **workspace\_id** `integer` *required*
>
> Workspace ID in the URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Groups Import
>
> **Slug:** `MIXPANEL_CREATE_GROUPS_IMPORT`
>
> Create a warehouse import that syncs group properties to Mixpanel group profiles. Requires an existing warehouse source, group key, and group identifier column. Creation may initiate data ingestion.
>
> #### Input Parameters
>
> **group\_key** `string` *required*
>
> Mixpanel group key to sync.
>
> **run\_every** `integer ("0" | "3600000000000" | "86400000000000" | "604800000000000")`
>
> Sync interval in nanoseconds: 0 (API only), 3600000000000 (hourly), 86400000000000 (daily), or 604800000000000 (weekly).
>
> **sync\_mode** `string ("time_based" | "mirror_mode" | "full_sync" | "one_time")` *required*
>
> Incremental time\_based, mirror\_mode, full\_sync, or one\_time sync.
>
> **project\_id** `string` *required*
>
> Mixpanel project ID.
>
> **import\_type** `string` *required*
>
> Import type; must be groups.
>
> **table\_params** `object` *required*
>
> Warehouse-specific table location object.
>
> **group\_id\_column** `string` *required*
>
> Warehouse column containing the group identifier.
>
> **databricks\_params** `object`
>
> Databricks-specific export cluster settings, or null.
>
> **property\_mappings** `object`
>
> Property mapping string pairs, or null.
>
> **warehouse\_source\_id** `integer` *required*
>
> ID of the existing warehouse source.
>
> **insert\_time\_column\_name** `string`
>
> Insert timestamp column for incremental sync, or null.
>
> **json\_properties\_column\_name** `string`
>
> JSON group properties column, or null.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Identity
>
> **Slug:** `MIXPANEL_CREATE_IDENTITY`
>
> Send a Mixpanel identity mapping event linking an anonymous ID with an identified user ID, typically after authentication, to connect anonymous activity with the identified user. This action is not suitable for India-residency projects.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Project authentication token for client-side authentication.
>
> **strict** `integer ("0" | "1")`
>
> Validation mode for the request.
>
> **anon\_id** `string` *required*
>
> The anonymous ID (UUID v4 format) to be linked with the identified user ID. This is typically the ID used before the user authenticated.
>
> **distinct\_id** `string`
>
> Optional distinct ID. If provided, this will be used as the post-ID for the identity.
>
> **identified\_id** `string` *required*
>
> The identified user ID to link with the anonymous ID. This is typically the user's ID after they sign up or log in.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Lookup Table Import
>
> **Slug:** `MIXPANEL_CREATE_LOOKUP_TABLE_IMPORT`
>
> Create a warehouse lookup-table import to enrich event or user properties. Requires an existing warehouse source, a Mixpanel join property, and its matching warehouse key column. Creation may initiate data ingestion.
>
> #### Input Parameters
>
> **run\_every** `integer ("0" | "3600000000000" | "86400000000000" | "604800000000000")`
>
> Sync interval in nanoseconds: 0 (API only), 3600000000000 (hourly), 86400000000000 (daily), or 604800000000000 (weekly).
>
> **sync\_mode** `string ("full_sync" | "one_time")` *required*
>
> Re-sync all data on each run, or sync once.
>
> **project\_id** `string` *required*
>
> Mixpanel project ID.
>
> **import\_type** `string` *required*
>
> Import type; must be lookup\_table.
>
> **table\_params** `object` *required*
>
> Warehouse-specific table location object; keys depend on the source warehouse (BigQuery, Snowflake, Redshift, Databricks, or PostgreSQL).
>
> **databricks\_params** `object`
>
> Databricks-specific export cluster settings, or null.
>
> **mixpanel\_property** `object` *required*
>
> Mixpanel property whose values match the warehouse join key.
>
> **warehouse\_source\_id** `integer` *required*
>
> ID of the existing warehouse source.
>
> **property\_key\_column\_name** `string` *required*
>
> Warehouse column containing join key values to match against mixpanel\_property.value.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create People Import
>
> **Slug:** `MIXPANEL_CREATE_PEOPLE_IMPORT`
>
> Create a warehouse import that syncs table rows to Mixpanel user profiles. Requires an existing warehouse source and a user identifier column. Each row represents a user. Creation may initiate data ingestion.
>
> #### Input Parameters
>
> **run\_every** `integer ("0" | "3600000000000" | "86400000000000" | "604800000000000")`
>
> Sync interval in nanoseconds: 0 (API only), 3600000000000 (hourly), 86400000000000 (daily), or 604800000000000 (weekly).
>
> **sync\_mode** `string ("time_based" | "mirror_mode" | "full_sync" | "one_time")` *required*
>
> time\_based, mirror\_mode, full\_sync, or one\_time sync.
>
> **project\_id** `string` *required*
>
> Mixpanel project ID.
>
> **import\_type** `string` *required*
>
> Import type; must be people.
>
> **table\_params** `object` *required*
>
> Warehouse-specific table location object.
>
> **user\_column\_name** `string` *required*
>
> Column containing the user identifier; each row is a user.
>
> **databricks\_params** `object`
>
> Databricks-specific export cluster settings, or null.
>
> **property\_mappings** `object`
>
> Property mapping string pairs, or null.
>
> **warehouse\_source\_id** `integer` *required*
>
> ID of the existing warehouse source.
>
> **insert\_time\_column\_name** `string`
>
> Insert timestamp column for incremental sync, or null.
>
> **json\_properties\_column\_name** `string`
>
> JSON user properties column, or null.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Service Account
>
> **Slug:** `MIXPANEL_CREATE_SERVICE_ACCOUNT`
>
> Tool to create a new service account for your organization and optionally add it to projects. Use when you need to generate API credentials for programmatic access. The response includes a token (secret) that cannot be recovered after creation. Requires service account with admin or owner role.
>
> #### Input Parameters
>
> **role** `string ("owner" | "admin" | "analyst" | "consumer")`
>
> The organization-level role for the service account. If not specified, service account will have no organization-level role.
>
> **expires** `string`
>
> ISO 8601 date-time format string indicating when the service account should expire. If not specified, the service account will have no expiration.
>
> **projects** `array`
>
> List of projects to add the service account to with specified roles. If not specified, the service account will not be added to any projects.
>
> **username** `string` *required*
>
> A descriptive name for the service account
>
> **organization\_id** `string` *required*
>
> The unique identifier for the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Decide Experiment
>
> **Slug:** `MIXPANEL_DECIDE_EXPERIMENT`
>
> Record whether a Mixpanel workspace experiment succeeded, with an optional variant and decision message. Returns the decided experiment. Requires a service account with workspace access.
>
> #### Input Parameters
>
> **message** `string`
>
> Message accompanying the experiment decision. Omitted or null messages are sent as an empty string, which the live API requires.
>
> **success** `boolean` *required*
>
> Whether the experiment was successful.
>
> **variant** `string`
>
> Experiment variant associated with the decision.
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to decide.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete All Schemas
>
> **Slug:** `MIXPANEL_DELETE_ALL_SCHEMAS`
>
> Delete all event and profile Lexicon schemas in a Mixpanel project. Removes the project's entire data dictionary. Requires a service account with access to the project. No optional filters are documented.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID whose entire Lexicon to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Annotation
>
> **Slug:** `MIXPANEL_DELETE_ANNOTATION`
>
> Delete an annotation by project and numeric annotation ID. Requires a service account with access to the project and a role of at least Analyst. Returns the deleted annotation's ID.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Project containing the annotation.
>
> **annotation\_id** `string` *required*
>
> Numeric ID of the annotation to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Entity Schemas
>
> **Slug:** `MIXPANEL_DELETE_ENTITY_SCHEMAS`
>
> Delete Lexicon schemas of one entity type in a Mixpanel project. Deletes all event or profile schemas unless entity\_name restricts the deletion to a named entity. Removes data dictionary schemas, not ingested events or user profiles. Requires a service account with project access.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID whose schemas to delete.
>
> **entity\_name** `string`
>
> Optional entity name, such as Added To Cart, to restrict deletion. When omitted, deletes all schemas of the selected entity type.
>
> **entity\_type** `string ("event" | "profile")` *required*
>
> Entity type whose schemas to delete: event or profile.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Experiment
>
> **Slug:** `MIXPANEL_DELETE_EXPERIMENT`
>
> Delete an experiment from a Mixpanel workspace. Requires a service account with access to the workspace. Returns the provider's deletion result, which may be an empty object on success.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment to delete.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Feature Flag
>
> **Slug:** `MIXPANEL_DELETE_FEATURE_FLAG`
>
> Delete one feature flag by ID in a project workspace. Uses Mixpanel's regional application API and service-account authentication. Returns the complete provider deletion result, which may be an empty object.
>
> #### Input Parameters
>
> **flag\_id** `string` *required*
>
> Feature flag ID in the URL path.
>
> **project\_id** `integer` *required*
>
> Project ID in the URL path.
>
> **workspace\_id** `integer` *required*
>
> Workspace ID in the URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Group
>
> **Slug:** `MIXPANEL_DELETE_GROUP`
>
> Tool to permanently delete a group profile from Mixpanel Group Analytics. Use when you need to completely remove a group profile and all of its properties. The deletion is permanent and cannot be undone. Note that group properties on historical events remain intact even after group deletion.
>
> #### Input Parameters
>
> **time** `integer`
>
> Unix timestamp in milliseconds for when the deletion should be recorded. If not provided, current time is used.
>
> **token** `string` *required*
>
> Your Mixpanel project token for authentication.
>
> **group\_id** `string` *required*
>
> The unique identifier for the specific group to permanently delete. This is the only parameter that determines which group profile is deleted.
>
> **group\_key** `string` *required*
>
> The group category/type identifier (e.g., 'company', 'organization', 'team'). This identifies the type of group being deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Profile
>
> **Slug:** `MIXPANEL_DELETE_PROFILE`
>
> Tool to permanently delete a user profile from Mixpanel, along with all of its properties. Use when you need to completely remove a profile. The deletion is permanent and cannot be undone. Note that this only deletes the profile, not the associated events. For duplicate profiles, use \$ignore\_alias: true to avoid deleting the original profile.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address for request attribution. Set to '0' to not update geolocation data.
>
> **token** `string` *required*
>
> Project authentication token for API authentication.
>
> **distinct\_id** `string` *required*
>
> Unique identifier for the user profile to permanently delete. This is the only parameter that determines which profile is deleted.
>
> **ignore\_time** `boolean`
>
> If true, Mixpanel will not automatically update the 'Last Seen' property before deletion.
>
> **ignore\_alias** `boolean`
>
> If true, prevents deletion of the original profile when deleting duplicates using an alias as distinct\_id. Important for avoiding unintended deletions of merged profiles.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Multiple Profiles (Batch)
>
> **Slug:** `MIXPANEL_DELETE_PROFILE_BATCH`
>
> Tool to permanently delete multiple user profiles from Mixpanel in a single batch request. Use when you need to delete multiple profiles efficiently. The deletion is permanent and cannot be undone. This only deletes the profiles, not the associated events. For duplicate profiles, use \$ignore\_alias: true to avoid deleting the original profile.
>
> #### Input Parameters
>
> **profiles** `array` *required*
>
> List of profile delete operations to execute. Each profile must include \$token, \$distinct\_id, and \$delete. Maximum 50 deletions per request recommended.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Profile Property
>
> **Slug:** `MIXPANEL_DELETE_PROFILE_PROPERTY`
>
> Tool to permanently delete properties from a Mixpanel user profile using the \$unset operation. Use when you need to remove specific properties and their values from a profile. Properties are permanently removed and cannot be recovered. Useful when cleaning up properties or approaching Mixpanel's limit of 2000 properties per profile.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address for request attribution. Set to '0' to not update geolocation data.
>
> **time** `integer`
>
> Unix timestamp for when the operation occurred.
>
> **token** `string` *required*
>
> Project authentication token for API authentication.
>
> **unset** `array` *required*
>
> List of property names to permanently remove from the profile. Properties are permanently deleted and cannot be recovered.
>
> **distinct\_id** `string` *required*
>
> Unique identifier for the user profile to update.
>
> **ignore\_time** `boolean`
>
> If true, Mixpanel will not automatically update the 'Last Seen' property.
>
> **ignore\_alias** `boolean`
>
> If true, ignores alias processing and uses the distinct\_id directly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Schema
>
> **Slug:** `MIXPANEL_DELETE_SCHEMA`
>
> Delete the Lexicon schema for one entity type and exact entity name. Removes a data dictionary schema, not ingested events or user profiles. Requires a service account with access to the project.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Exact entity name whose schema to delete, such as Added To Cart.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID containing the schema.
>
> **entity\_type** `string ("event" | "profile")` *required*
>
> Entity type of the schema: event or profile.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Service Account
>
> **Slug:** `MIXPANEL_DELETE_SERVICE_ACCOUNT`
>
> Delete a service account from an organization and remove it from all associated projects. Requires a service account with organization admin or owner access. This permanently revokes the deleted account's access.
>
> #### Input Parameters
>
> **organization\_id** `integer` *required*
>
> Organization containing the service account.
>
> **service\_account\_id** `integer` *required*
>
> ID of the existing service account to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Warehouse Import
>
> **Slug:** `MIXPANEL_DELETE_WAREHOUSE_IMPORT`
>
> Delete a warehouse import from a Mixpanel project. Requires a service account with project access. By default imported data is retained; delete\_data=true also creates a request to delete imported events.
>
> #### Input Parameters
>
> **import\_id** `integer` *required*
>
> Warehouse import ID.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID.
>
> **delete\_data** `boolean`
>
> Also request deletion of imported events from Mixpanel. Defaults to false; omit to retain imported data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Evaluate Feature Flags
>
> **Slug:** `MIXPANEL_EVALUATE_FEATURE_FLAGS`
>
> Evaluate all enabled feature flags for a user and return eligible variants. Uses the connection's US, EU, or India region and existing authentication. Supply project\_id for service-account authentication. Unlike listing flag definitions, this evaluates eligibility using the user's runtime context.
>
> #### Input Parameters
>
> **token** `string`
>
> Your Mixpanel project token.
>
> **context** `object` *required*
>
> User and runtime context; serialized as JSON in the query.
>
> **project\_id** `string`
>
> Mixpanel project ID. Provide when using service account auth.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export Raw Events
>
> **Slug:** `MIXPANEL_EXPORT_RAW_EVENTS`
>
> Export raw Mixpanel events for a date range with optional filters. Results are limited to 1,000 events by default, with a configurable maximum of 100,000; the response reports whether the export terminated early.
>
> #### Input Parameters
>
> **event** `array`
>
> Event names to export
>
> **limit** `integer`
>
> Maximum number of events to return (default 1000, up to 100000). When the limit is reached, terminated\_early is true; narrow the date range or filters to fetch the rest.
>
> **where** `string`
>
> Mixpanel expression used to filter events
>
> **to\_date** `string` *required*
>
> Inclusive end date in YYYY-MM-DD format
>
> **from\_date** `string` *required*
>
> Inclusive start date in YYYY-MM-DD format
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID required by service-account authentication
>
> **time\_in\_ms** `boolean`
>
> Return event timestamps with millisecond precision
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Force Conclude Experiment
>
> **Slug:** `MIXPANEL_FORCE_CONCLUDE_EXPERIMENT`
>
> Force conclude an experiment in a Mixpanel workspace, optionally specifying its end date. Returns the updated experiment. Requires a service account with access to the workspace.
>
> #### Input Parameters
>
> **end\_date** `string`
>
> Optional experiment end date. The API accepts a string without a documented format constraint; omitted when unset.
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment to force conclude.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to force conclude.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Projects
>
> **Slug:** `MIXPANEL_GET_ALL_PROJECTS`
>
> Get all projects associated with the authenticated Mixpanel account. Returns project details including name, permissions, role, domain, and other configuration details. If a project appears inaccessible, verify the connection region matches the project's cluster before assuming a permissions issue.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Annotation
>
> **Slug:** `MIXPANEL_GET_ANNOTATION`
>
> Retrieve one annotation by project and numeric annotation ID, including its date, description, creator, and tags. Requires a service account with access to the project.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Project containing the annotation.
>
> **annotation\_id** `string` *required*
>
> Numeric ID of the annotation to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Annotation Tags
>
> **Slug:** `MIXPANEL_GET_ANNOTATION_TAGS_ALT1`
>
> Tool to get all annotation tags from a Mixpanel project. Use when you need to retrieve tags that have been added to annotations. Requires a role of at least Analyst.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> The unique identifier for the Mixpanel project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Dashboard
>
> **Slug:** `MIXPANEL_GET_DASHBOARD`
>
> Retrieve one Mixpanel dashboard, including its contents and layout.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID that owns the dashboard.
>
> **dashboard\_id** `integer` *required*
>
> Numeric dashboard ID to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Data Deletion
>
> **Slug:** `MIXPANEL_GET_DATA_DELETION`
>
> Check a GDPR or CCPA data deletion job using its tracking ID and project token. Returns the job status, requesting user, project, timestamp, and distinct IDs. Uses the connected account's regional application API; does not create or cancel jobs. Requires the provider's documented OAuth bearer authentication for GDPR endpoints.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Project token for the deletion job.
>
> **tracking\_id** `string` *required*
>
> Task ID returned when the data deletion job was created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Data Retrieval
>
> **Slug:** `MIXPANEL_GET_DATA_RETRIEVAL`
>
> Check a GDPR or CCPA data retrieval job using its tracking ID and project token. Returns the job status, distinct IDs, and export URL when available. Does not download the export. Uses the connected account's regional application API. Requires the provider's documented OAuth bearer authentication for GDPR endpoints.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Project token for the retrieval job.
>
> **tracking\_id** `string` *required*
>
> Task ID returned when the data retrieval job was created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Experiment
>
> **Slug:** `MIXPANEL_GET_EXPERIMENT`
>
> Retrieve one experiment by workspace and experiment ID, including its settings, variants, metrics, cached results, and linked feature flag when available. Requires a service account with access to the workspace.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Feature Flag
>
> **Slug:** `MIXPANEL_GET_FEATURE_FLAG`
>
> Get one feature flag by ID in a project workspace. Uses Mixpanel's regional application API and service-account authentication. Returns the complete flag, including rules, nullable metadata and future fields.
>
> #### Input Parameters
>
> **flag\_id** `string` *required*
>
> Feature flag ID in the URL path.
>
> **project\_id** `integer` *required*
>
> Project ID in the URL path.
>
> **workspace\_id** `integer` *required*
>
> Workspace ID in the URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Flag Definitions
>
> **Slug:** `MIXPANEL_GET_FLAG_DEFINITIONS`
>
> Retrieve all enabled feature flag definitions for the authenticated project. Returns complete metadata, variants, rulesets, and rollout configurations. Uses the US, EU, or India Feature Flags API for the connection's region. Supply project\_id for service-account authentication; token is optional.
>
> #### Input Parameters
>
> **token** `string`
>
> Optional Mixpanel project token.
>
> **project\_id** `string`
>
> Mixpanel project ID. Provide when using service-account authentication.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Import History
>
> **Slug:** `MIXPANEL_GET_IMPORT_HISTORY`
>
> Get the 30 most recent execution events for a warehouse import. Requires the project ID, import ID, and a service account with project access. Returns run statuses, timing, and imported event counts. No query filters or pagination options are documented.
>
> #### Input Parameters
>
> **import\_id** `integer` *required*
>
> Warehouse import ID.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Schema
>
> **Slug:** `MIXPANEL_GET_SCHEMA`
>
> Get the Lexicon schema for a specific event or profile name. Returns the entity's JSON Schema directly, including property definitions and metadata. Requires a service account with access to the project. Use List Schemas to discover entity names. No optional filters or pagination are documented.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Exact entity name, such as Added To Cart or \$user.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID containing the schema.
>
> **entity\_type** `string ("event" | "profile")` *required*
>
> Entity type whose schema to retrieve: event or profile.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Service Account
>
> **Slug:** `MIXPANEL_GET_SERVICE_ACCOUNT`
>
> Retrieve a service account's details by organization and service account ID, including its username, creation, last-use, and expiration times. Requires a service account with organization admin or owner access. Does not recover secrets.
>
> #### Input Parameters
>
> **organization\_id** `integer` *required*
>
> Organization containing the service account.
>
> **service\_account\_id** `integer` *required*
>
> ID of the existing service account to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Warehouse Import
>
> **Slug:** `MIXPANEL_GET_WAREHOUSE_IMPORT`
>
> Get a warehouse import's full configuration, column mappings, and sync settings. Requires the project ID and the warehouse import ID. Does not modify the import.
>
> #### Input Parameters
>
> **import\_id** `integer` *required*
>
> Warehouse import ID.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Update Group Profiles
>
> **Slug:** `MIXPANEL_GROUP_BATCH_UPDATE`
>
> Send a batch of Mixpanel group profile updates in one request. Updates can set or set-once properties, add or remove list values, unset properties, or delete group profiles. This action is not suitable for India-residency projects.
>
> #### Input Parameters
>
> **data** `array` *required*
>
> A list of group profile update objects. Each object contains the group identifiers and operations to perform.
>
> **response\_format** `string ("IP" | "Strict" | "Verbose")`
>
> Controls response format. IP: returns '1' for valid data, Strict: returns error for any invalid records, Verbose: detailed response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Group Properties
>
> **Slug:** `MIXPANEL_GROUP_DELETE_PROPERTY`
>
> Tool to delete specific properties from a Mixpanel group profile. Use when you need to permanently remove unwanted properties from a group (company, organization, team, etc.). The operation uses the \$unset operation to permanently remove the specified properties.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Your Mixpanel project authentication token
>
> **group\_id** `string` *required*
>
> The unique identifier for the specific group to update
>
> **group\_key** `string` *required*
>
> The group category/type identifier (e.g., 'company', 'organization', 'team')
>
> **properties** `array` *required*
>
> List of property names to delete/unset from the group profile
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Group Properties (Batch) (Deprecated)
>
> **Slug:** `MIXPANEL_GROUP_SET_PROPERTY`
>
> DEPRECATED: Use MIXPANEL\_GROUP\_BATCH\_UPDATE instead. Tool to send batch group profile updates to Mixpanel. Use when you need to update properties for one or more groups (companies, organizations, teams, etc.). Supports multiple operations: \$set (update/add), \$set\_once (set if not exists), \$unset (delete), \$remove (remove from list), \$union (add to list uniquely).
>
> #### Input Parameters
>
> **groups** `array` *required*
>
> List of group profile updates to send. Each update must include \$token, \$group\_key, \$group\_id, and at least one operation (\$set, \$set\_once, \$unset, \$remove, or \$union)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Identity Alias
>
> **Slug:** `MIXPANEL_IDENTITY_CREATE_ALIAS`
>
> Send an alias mapping to link a new Mixpanel distinct ID with an existing one, such as during signup. This is for Original ID Merge or Legacy ID Management projects; each alias can map to only one distinct ID. This action is not suitable for India-residency projects.
>
> #### Input Parameters
>
> **alias** `string` *required*
>
> A new distinct\_id value that will be interpreted as the existing distinct\_id. Each alias can only map to one distinct\_id. Typically set during user signup to connect anonymous pre-signup events with post-signup activity.
>
> **token** `string` *required*
>
> Project authentication token for client-side authentication.
>
> **distinct\_id** `string` *required*
>
> The existing distinct ID to be merged with the alias. This is the original identifier that the alias will map to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Import Events
>
> **Slug:** `MIXPANEL_IMPORT_EVENTS`
>
> Import a batch of historical events into a Mixpanel project. A partial import can return the number imported alongside failed records.
>
> #### Input Parameters
>
> **events** `array` *required*
>
> One to 2000 historical events to import. The uncompressed request body must be no larger than 10 MB.
>
> **strict** `boolean`
>
> Validate every event and return details for records that fail.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID receiving the events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute JQL Query
>
> **Slug:** `MIXPANEL_JQL_QUERY`
>
> Execute a custom JQL (JavaScript Query Language) query against Mixpanel's Query API. Key Constraints: - 60 queries/hour, max 5 concurrent queries. - 2-minute execution timeout. - 5 GB data processing limit, 2 GB output limit. - No remote network requests (XMLHttpRequest) are allowed inside the JQL script.
>
> #### Input Parameters
>
> **params** `object`
>
> A JSON-encoded object that will be made available in the script as `params`. Use this to pass dynamic date ranges, event names, or other parameters into your JQL query.
>
> **script** `string` *required*
>
> A fully valid JavaScript code snippet for Mixpanel's JQL engine. MUST define exactly one top-level `function main() { ... }` that returns the final dataset.  DATA SOURCES: - Events(\{ from\_date: 'YYYY-MM-DD', to\_date: 'YYYY-MM-DD', event\_selectors: \[\{ event: 'Name', selector: '...' }] }) - returns objects with name, distinct\_id, time (ms epoch), properties. - People(\{ user\_selectors: \[\{ selector: '...' }] }) - returns objects with distinct\_id, time, last\_seen, properties. - join(Events(...), People(), \{ type: 'full'|'left'|'right'|'inner', selectors: \[...] }) - combines events and profiles on distinct\_id; each item has \{ distinct\_id, event, user }.  TRANSFORMATIONS (chainable): - .filter(fn) - keep items where fn returns true - .map(fn) - transform each item - .reduce(reducerFn) - aggregate entire collection to one value - .groupBy(keys, reducer) - group by property paths or functions, returns \[\{ key, value }] - .groupByUser(\[keys], reducer) - group events per user in chronological order; reducer signature: (state, events) => newState - .sortAsc(accessor) / .sortDesc(accessor) - sort by property or function - .flatten() - flatten nested arrays  BUILT-IN REDUCERS (use with .reduce() or .groupBy()): mixpanel.reducer.count(), .sum(accessor), .avg(accessor), .min(accessor), .max(accessor), .min\_by(accessor), .max\_by(accessor), .numeric\_percentiles(accessor, \[p1, p2, ...]), .top(N), .any(), .null(), .object\_merge()  SEGMENTATION EXPRESSIONS (for event\_selectors/user\_selectors/join selectors): Operators: ==, !=, >, >=, \<, \<=, in, and, or, not. Typecasts: string(...), number(...), boolean(...). Example: properties\["app\_name"] == "gmail" and user\["age"] > 30  PARAMS: Pass dynamic values via the `params` field. Accessible in script as the global `params` variable.  EXAMPLE: `js function main() {   return Events({ from_date: '2025-01-01', to_date: '2025-01-31', event_selectors: [{ event: 'purchase' }] })     .filter(e => e.properties.country === 'CA')     .groupBy(['properties.city'], mixpanel.reducer.count()); } `  The return value from main() can be an array of objects, a single number (from .reduce()), or a nested array (from .groupBy()).
>
> **project\_id** `integer` *required*
>
> Required if using service account credentials or an API secret for authentication.
>
> **workspace\_id** `integer`
>
> The ID of the Mixpanel workspace, if applicable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Launch Experiment
>
> **Slug:** `MIXPANEL_LAUNCH_EXPERIMENT`
>
> Launch an experiment in a Mixpanel workspace. Returns the updated experiment. Requires a service account with access to the workspace.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment to launch.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to launch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Annotations
>
> **Slug:** `MIXPANEL_LIST_ANNOTATIONS`
>
> List annotations in a Mixpanel project, optionally filtering by inclusive start and end dates. Returns annotation text, dates, creators, and tags. Requires a service account with access to the project. No pagination is documented.
>
> #### Input Parameters
>
> **to\_date** `string`
>
> Inclusive end date in yyyy-mm-dd format.
>
> **from\_date** `string`
>
> Inclusive start date in yyyy-mm-dd format.
>
> **project\_id** `integer` *required*
>
> Mixpanel project whose annotations to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Saved Cohorts (Deprecated)
>
> **Slug:** `MIXPANEL_LIST_COHORTS`
>
> DEPRECATED: Use MIXPANEL\_MIXPANEL\_COHORTS\_LIST instead. Get list of all cohorts in a Mixpanel project. Returns cohort details including name, id, count, description, creation date, and visibility. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> The ID of the project to query. Required if using service account authentication.
>
> **workspace\_id** `integer`
>
> The ID of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Entity Schemas
>
> **Slug:** `MIXPANEL_LIST_ENTITY_SCHEMAS`
>
> List Lexicon schemas for an event or profile entity type in a project. Optionally filter by entity\_name. Returns entity names and their complete JSON Schemas. A named lookup is normalized to a single-item results list. Requires a service account with access to the project. No pagination is documented.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID whose schemas to list.
>
> **entity\_name** `string`
>
> Optional entity name to filter by, such as Added To Cart.
>
> **entity\_type** `string ("event" | "profile")` *required*
>
> Entity type whose schemas to list: event or profile.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Experiments
>
> **Slug:** `MIXPANEL_LIST_EXPERIMENTS`
>
> List experiments in a Mixpanel workspace, including their settings, variants, metrics, lifecycle status, and access information. Requires a service account with access to the workspace. This endpoint has no documented pagination.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Workspace whose experiments to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Feature Flags
>
> **Slug:** `MIXPANEL_LIST_FEATURE_FLAGS`
>
> List feature flags in a project workspace, optionally including archived flags. Uses Mixpanel's regional application API and service-account authentication. Returns the complete provider response with flag definitions and metadata.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Project ID in the URL path.
>
> **workspace\_id** `integer` *required*
>
> Workspace ID in the URL path.
>
> **include\_archived** `string ("true" | "false")`
>
> Include archived (soft-deleted) flags. Defaults to false when omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Saved Funnels
>
> **Slug:** `MIXPANEL_LIST_FUNNELS`
>
> Get the names and funnel\_ids of your funnels. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Lookup Tables
>
> **Slug:** `MIXPANEL_LIST_LOOKUP_TABLES`
>
> List lookup tables defined in a Mixpanel project. Uses service-account authentication and the project's regional ingestion API. Returns lookup table IDs and names; an empty project may return null results.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> Mixpanel project\_id used to authenticate service account credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Project Service Accounts
>
> **Slug:** `MIXPANEL_LIST_PROJECT_SERVICE_ACCOUNTS`
>
> List service accounts that are members of a project, including their roles, membership grant types, sensitive-data access, and last-use/expiration times. Requires service account authentication with access to the specified project. An account may appear multiple times when it has multiple membership grants.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> ID of the project whose service account members to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Saved Cohorts (Deprecated)
>
> **Slug:** `MIXPANEL_LIST_SAVED_COHORTS`
>
> DEPRECATED: Use MIXPANEL\_MIXPANEL\_COHORTS\_LIST instead. Tool to list all saved cohorts in a Mixpanel project. Use when you need to retrieve cohort metadata including name, id, count, description, creation date, and visibility for every cohort in the project.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> The ID of the project to query. Required for listing cohorts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Schemas
>
> **Slug:** `MIXPANEL_LIST_SCHEMAS`
>
> List all Lexicon schemas in a Mixpanel project. Returns event and profile entity names and their complete JSON Schemas. Requires a service account with access to the project. No pagination or optional filters are documented.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID whose schemas to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Service Accounts
>
> **Slug:** `MIXPANEL_LIST_SERVICE_ACCOUNTS`
>
> Tool to list all service accounts for an organization. Use when you need to retrieve service accounts, check when they were last used, or see when they expire. Requires service account with admin or owner role.
>
> #### Input Parameters
>
> **organization\_id** `string` *required*
>
> The unique identifier for the organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Warehouse Imports
>
> **Slug:** `MIXPANEL_LIST_WAREHOUSE_IMPORTS`
>
> List all warehouse imports configured for a Mixpanel project, including configuration, sync status, and scheduling metadata. Requires a service account with access to the project. No filters or pagination are documented.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Mixpanel project whose warehouse imports to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Append to Profile List Property
>
> **Slug:** `MIXPANEL_PROFILE_APPEND_TO_LIST_PROPERTY`
>
> Tool to append values to list properties on user profiles in Mixpanel. Use when you need to add items to list-type properties. Unlike \$union, \$append allows duplicate values. If the property doesn't exist, it creates a new list with the value as the first element.
>
> #### Input Parameters
>
> **data** `array` *required*
>
> A list of profile update objects. Each object must contain \$token, \$distinct\_id, and \$append properties.
>
> **verbose** `integer`
>
> When set to 1, returns detailed JSON response with status and error fields. When set to 0 (default), returns plain text status (1 for success, 0 for failure).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Multiple Profiles (Batch)
>
> **Slug:** `MIXPANEL_PROFILE_BATCH_UPDATE`
>
> Tool to update multiple user profiles in Mixpanel in a single batch request. Use when you need to update properties for multiple users efficiently. Supports operations: \$set (update/add), \$set\_once (set if not exists), \$add (increment), \$union (add to list uniquely), \$append (append to list), \$remove (remove from list), \$unset (delete property), \$delete (delete profile). Maximum 50 updates per request. Always check the response status and failed\_records for individual update failures.
>
> #### Input Parameters
>
> **profiles** `array` *required*
>
> List of profile updates to send. Maximum 50 updates per request. Each profile must include \$token and either \$distinct\_id or \$user\_id, plus at least one operation (\$set, \$set\_once, \$add, \$union, \$append, \$remove, \$unset, or \$delete).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Profile Property (Deprecated)
>
> **Slug:** `MIXPANEL_PROFILE_DELETE_PROPERTY`
>
> DEPRECATED: Use MIXPANEL\_DELETE\_PROFILE\_PROPERTY instead. Tool to permanently delete properties from a user profile in Mixpanel. Use when you need to remove specific properties and their values from a profile. This operation uses \$unset and permanently removes properties that cannot be recovered. Useful when cleaning up properties or approaching Mixpanel's limit of 2000 properties per profile.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address for request attribution. Set to '0' to not update geolocation data.
>
> **time** `integer`
>
> Unix timestamp for when the operation occurred.
>
> **token** `string` *required*
>
> Project authentication token for API authentication.
>
> **unset** `array` *required*
>
> JSON list of property names to permanently remove from the profile. Properties are permanently deleted and cannot be recovered.
>
> **distinct\_id** `string` *required*
>
> Unique identifier for the user profile to update.
>
> **ignore\_time** `boolean`
>
> If true, Mixpanel will not automatically update the 'Last Seen' property.
>
> **ignore\_alias** `boolean`
>
> If true, ignores alias processing and uses the distinct\_id directly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Profile Event Activity
>
> **Slug:** `MIXPANEL_PROFILE_EVENT_ACTIVITY`
>
> Get event activity feed for specified users from Mixpanel Query API. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **to\_date** `string` *required*
>
> End date for the query (inclusive, format: YYYY-MM-DD)
>
> **from\_date** `string` *required*
>
> Start date for the query (inclusive, format: YYYY-MM-DD)
>
> **project\_id** `integer` *required*
>
> The ID of the project to query. Required if using service account authentication.
>
> **distinct\_ids** `array` *required*
>
> List of distinct\_ids to return activity feeds for
>
> **workspace\_id** `integer`
>
> The ID of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Increment Profile Numerical Property
>
> **Slug:** `MIXPANEL_PROFILE_NUMERICAL_ADD`
>
> Tool to increment or decrement numerical properties on user profiles in Mixpanel. Use when you need to add values to existing numerical properties (e.g., login counts, points, credits). Properties are incremented by the specified amount. If a property doesn't exist, the value is added to zero. Use negative values to decrement properties.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address for geolocation. Set to 0 or '0' to avoid updating location data. Defaults to the request IP address if not provided.
>
> **add** `object` *required*
>
> A JSON object containing property names as keys and numerical increment values. Properties will be incremented by the specified amount. If a property doesn't exist, the value is added to zero. Use negative values to decrement.
>
> **time** `integer`
>
> Unix timestamp to override the time of the update. If not provided, uses current server time.
>
> **token** `string` *required*
>
> Your Mixpanel project authentication token
>
> **verbose** `integer`
>
> When set to 1, returns detailed JSON response with status and error fields. When set to 0 (default), returns plain text status (1 for success, 0 for failure).
>
> **distinct\_id** `string` *required*
>
> The unique identifier for the user profile
>
> **ignore\_time** `boolean`
>
> If true, prevents updating the 'Last Seen' property. Defaults to false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove from Profile List Property
>
> **Slug:** `MIXPANEL_PROFILE_REMOVE_FROM_LIST_PROPERTY`
>
> Tool to remove values from list properties on user profiles in Mixpanel. Use when you need to remove specific items from list-type properties. If the value doesn't exist in the list, no updates are made. If the property doesn't exist or is not list-valued, the operation is ignored.
>
> #### Input Parameters
>
> **data** `array` *required*
>
> A list of profile update objects. Each object must contain \$token, \$distinct\_id, and \$remove properties.
>
> **verbose** `integer`
>
> When set to 1, returns detailed JSON response with status and error fields. When set to 0 (default), returns plain text status (1 for success, 0 for failure).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Profile Properties
>
> **Slug:** `MIXPANEL_PROFILE_SET`
>
> Tool to set user profile properties in Mixpanel using the \$set operation. Use when you need to create or update properties on a user profile. Properties specified will be created if they don't exist, or overwritten if they do. If the profile doesn't exist, it will be created with these properties.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address for geolocation enrichment. Set to '0' to prevent updating geolocation data. If not provided, Mixpanel uses the request IP. Geolocation properties (\$city, \$region, mp\_country\_code) are derived and the IP is discarded.
>
> **time** `integer`
>
> Unix timestamp (seconds since epoch) indicating when the profile update occurred. Defaults to the current server time if not provided.
>
> **token** `string` *required*
>
> Your Mixpanel project authentication token. Required for authenticating the request.
>
> **distinct\_id** `string` *required*
>
> The unique identifier for the user profile to update. This determines which profile will be modified.
>
> **ignore\_time** `boolean`
>
> If true, prevents Mixpanel from automatically updating the 'Last Seen' property. Defaults to false.
>
> **set\_properties** `object` *required*
>
> A dictionary of properties to set on the user profile. These properties will be created if they don't exist, or overwritten if they do. Common properties include 'name', 'email', 'status', etc.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Frequency Report
>
> **Slug:** `MIXPANEL_QUERY_FREQUENCY_REPORT`
>
> Query how frequently users perform events over a specified period, returning date-keyed frequency arrays under data. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **on** `string`
>
> The property expression to segment the second event on
>
> **unit** `string ("day" | "week" | "month")` *required*
>
> The overall time period to return frequency of actions for
>
> **event** `string`
>
> The event to generate returning counts for
>
> **limit** `integer`
>
> Return the top limit segmentation values
>
> **where** `string`
>
> An expression to filter the returning events by
>
> **to\_date** `string` *required*
>
> The date in yyyy-mm-dd format to query to (inclusive)
>
> **from\_date** `string` *required*
>
> The date in yyyy-mm-dd format to begin querying from (inclusive)
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> **addiction\_unit** `string ("hour" | "day")` *required*
>
> The granularity to return frequency of actions at
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Saved Funnel
>
> **Slug:** `MIXPANEL_QUERY_FUNNEL`
>
> Get data for a funnel. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **on** `string`
>
> The property expression to segment the event on
>
> **unit** `string ("day" | "week" | "month")`
>
> Medium range time units for Mixpanel operations.
>
> **limit** `integer`
>
> Return the top property values. Maximum value 10,000
>
> **where** `string`
>
> An expression to filter events by
>
> **length** `integer`
>
> The number of units each user has to complete the funnel. May not be greater than 90 days
>
> **to\_date** `string` *required*
>
> The date in yyyy-mm-dd format to query to (inclusive)
>
> **interval** `integer`
>
> The number of days you want each bucket to contain
>
> **from\_date** `string` *required*
>
> The date in yyyy-mm-dd format to begin querying from (inclusive)
>
> **funnel\_id** `integer` *required*
>
> The funnel that you wish to get data for
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **length\_unit** `string ("second" | "minute" | "hour" | "day")`
>
> Extended time units including seconds for funnel analysis.
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Saved Insight
>
> **Slug:** `MIXPANEL_QUERY_INSIGHT`
>
> Get data from your Insights reports. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request Must match the configured connection region/cluster; a mismatch returns 'invalid project id for cluster'.
>
> **bookmark\_id** `integer` *required*
>
> The ID of your Insights report
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Top Event Names (Last 31 Days) (Deprecated)
>
> **Slug:** `MIXPANEL_QUERY_MONTHS_TOP_EVENT_NAMES`
>
> DEPRECATED: Use MIXPANEL\_TOP\_EVENTS instead. Get a list of the most common event names over the last 31 days. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries. Use when you need to discover what events are being tracked most frequently in your project.
>
> #### Input Parameters
>
> **type** `string ("general" | "unique" | "average")` *required*
>
> The analysis type for the query - general, unique, or average
>
> **limit** `integer`
>
> Maximum number of event names to return. Default is 255
>
> **project\_id** `integer` *required*
>
> The project identifier. Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The workspace identifier. Required only for projects with Data Views enabled
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Numeric Average Report
>
> **Slug:** `MIXPANEL_QUERY_NUMERIC_AVERAGE`
>
> Averages an expression for events per unit time. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries. Example response: \{ "status": "ok", "results": \{ "2024-01-01": 25.5, "2024-01-02": 32.75, "2024-01-03": 28.25 } }
>
> #### Input Parameters
>
> **on** `string` *required*
>
> The numeric expression to average per unit time (should evaluate to a number)
>
> **unit** `string ("hour" | "day")`
>
> Shorter time units for certain Mixpanel operations.
>
> **event** `string` *required*
>
> The event to get data for (single event name)
>
> **where** `string`
>
> An expression to filter events by
>
> **to\_date** `string` *required*
>
> The date in yyyy-mm-dd format to query to (inclusive)
>
> **from\_date** `string` *required*
>
> The date in yyyy-mm-dd format to begin querying from (inclusive)
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Numeric Sum Report
>
> **Slug:** `MIXPANEL_QUERY_NUMERIC_SUM`
>
> Sums an expression for events per unit time. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries. Example response: \{ "status": "ok", "computed\_at": "2024-01-20T12:00:00", "results": \{ "2024-01-01": 150.5, "2024-01-02": 245.75, "2024-01-03": 198.25 } }
>
> #### Input Parameters
>
> **on** `string` *required*
>
> The numeric expression to sum per unit time (should evaluate to a number)
>
> **unit** `string ("hour" | "day")`
>
> Shorter time units for certain Mixpanel operations.
>
> **event** `string` *required*
>
> The event to get data for (single event name)
>
> **where** `string`
>
> An expression to filter events by
>
> **to\_date** `string` *required*
>
> The date in yyyy-mm-dd format to query to (inclusive)
>
> **from\_date** `string` *required*
>
> The date in yyyy-mm-dd format to begin querying from (inclusive)
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Organization Audit Logs
>
> **Slug:** `MIXPANEL_QUERY_ORGANIZATION_AUDIT_LOGS`
>
> Query one page of organization audit logs with optional actor, time, project and event filters. Requires service account authentication and view\_audit\_logs permission (Owner or Admin). Pass a returned pagination cursor to retrieve another page.
>
> #### Input Parameters
>
> **body** `object`
>
> Optional audit log filters. An empty body queries all organization logs.
>
> **order** `string ("asc" | "desc")`
>
> Oldest first (asc) or newest first (desc).
>
> **cursor** `string`
>
> Previous or next cursor returned by a prior query.
>
> **page\_size** `integer`
>
> Items per page, from 1 to 100.
>
> **organization\_id** `string` *required*
>
> Organization's unique identifier.
>
> **mixpanel\_version** `string`
>
> Optional Mixpanel-Version date pin, e.g. 2026-08-13. Omit to use the latest API version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Profiles
>
> **Slug:** `MIXPANEL_QUERY_PROFILES`
>
> Query user or group profile data from Mixpanel. Returns list of profiles that match specified parameters. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **page** `integer`
>
> Which page of results to retrieve (starts at 0)
>
> **where** `string`
>
> An expression to filter users (or groups) by
>
> **behaviors** `integer`
>
> Required when using event selector for user profiles
>
> **project\_id** `integer` *required*
>
> The ID of the project to query. Required if using service account authentication.
>
> **session\_id** `string`
>
> Session ID from a previous query for pagination
>
> **distinct\_id** `string`
>
> A unique identifier used to distinguish an individual profile
>
> **distinct\_ids** `array`
>
> A list of distinct\_ids to retrieve profiles for
>
> **workspace\_id** `integer`
>
> The ID of the workspace if applicable
>
> **data\_group\_id** `string`
>
> The ID of the group key, used when querying group profiles
>
> **as\_of\_timestamp** `integer`
>
> Used with behaviors parameter for large exports
>
> **filter\_by\_cohort** `object`
>
> Filter by cohort ID. Example: \{'id': 12345}
>
> **include\_all\_users** `boolean`
>
> When using filter\_by\_cohort, whether to include all distinct\_ids even without profiles
>
> **output\_properties** `array`
>
> List of property names to return in the response
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Retention Report
>
> **Slug:** `MIXPANEL_QUERY_RETENTION_REPORT`
>
> Query cohort analysis showing user retention patterns over time. Tracks how users who performed an initial event (born\_event) subsequently perform a target event (event). Use the 'unit' parameter to control cohort interval granularity ('day', 'week', 'month'); defaults to 'day'.
>
> #### Input Parameters
>
> **on** `string`
>
> Property expression for segmentation (segments results by specified property)
>
> **unit** `string ("day" | "week" | "month")`
>
> Medium range time units for Mixpanel operations.
>
> **event** `string`
>
> The target event to measure retention against
>
> **limit** `integer`
>
> Maximum number of top segmentation values to return (only valid with 'on' parameter)
>
> **where** `string`
>
> Filter expression for event (see Mixpanel expressions documentation)
>
> **to\_date** `string` *required*
>
> End date for the query range in YYYY-MM-DD format (inclusive)
>
> **from\_date** `string` *required*
>
> Start date for the query range in YYYY-MM-DD format (inclusive)
>
> **born\_event** `string`
>
> The initial event that defines the cohort entry (required when retention\_type='birth')
>
> **born\_where** `string`
>
> Filter expression for born\_event (see Mixpanel expressions documentation)
>
> **project\_id** `integer` *required*
>
> Project identifier (required when using service account authentication)
>
> **workspace\_id** `integer`
>
> Workspace identifier if applicable
>
> **interval\_count** `integer`
>
> Number of individual buckets/intervals to return
>
> **retention\_type** `string ("birth" | "compounded")`
>
> Type of retention analysis: 'birth' for first-time retention or 'compounded' for recurring retention
>
> **unbounded\_retention** `boolean`
>
> When true, uses accumulation method where values accumulate from right to left
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Segmentation Report
>
> **Slug:** `MIXPANEL_QUERY_SEGMENTATION`
>
> Get data for an event, segmented and filtered by properties with daily/time-series breakdown. Use the 'unit' parameter to control time bucketing ('minute', 'hour', 'day', 'month'). The Query API has a rate limit of 60 queries per hour and 5 concurrent queries, shared across related tools (e.g., MIXPANEL\_JQL\_QUERY, MIXPANEL\_TOP\_EVENT\_PROPERTY\_VALUES); bursts of concurrent calls return 429.
>
> #### Input Parameters
>
> **on** `string`
>
> The property expression to segment the event on Properties unset for many events produce 'undefined' segment buckets; interpret as missing instrumentation, not zero traffic.
>
> **type** `string ("general" | "unique" | "average")`
>
> Analysis types for Mixpanel event aggregation.
>
> **unit** `string ("minute" | "hour" | "day" | "month")`
>
> Time units for segmentation queries.
>
> **event** `string` *required*
>
> The event to get data for (single event name)
>
> **limit** `integer`
>
> Return the top N property values (max 10000)
>
> **where** `string`
>
> An expression to filter events by
>
> **to\_date** `string` *required*
>
> The date in yyyy-mm-dd format to query to (inclusive)
>
> **from\_date** `string` *required*
>
> The date in yyyy-mm-dd format to begin querying from (inclusive) Use project timezone to avoid off-by-one-day range errors; reversed or overly narrow ranges yield empty results.
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request Region mismatch between the Mixpanel connection and the project's cluster returns 'invalid project id for cluster'; verify region before querying.
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Top Events
>
> **Slug:** `MIXPANEL_QUERY_TOP_EVENTS`
>
> Get the top events for today, with their counts and the normalized percent change from yesterday. Use when you need to analyze today's event performance compared to yesterday.
>
> #### Input Parameters
>
> **type** `string ("general" | "unique" | "average")` *required*
>
> The analysis type - general, unique, or average
>
> **limit** `integer`
>
> Maximum number of events to return
>
> **project\_id** `integer` *required*
>
> The project identifier. Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The workspace identifier if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove from Group List Property
>
> **Slug:** `MIXPANEL_REMOVE_FROM_GROUP_LIST_PROPERTY`
>
> Tool to remove values from list properties on group profiles in Mixpanel. Use when you need to remove specific items from list-type properties on groups (companies, organizations, etc.). If the value doesn't exist in the list, no updates are made. If the property doesn't exist or is not list-valued, the operation is ignored.
>
> #### Input Parameters
>
> **data** `array` *required*
>
> A list of group profile update objects. Each object must contain \$token, \$group\_key, \$group\_id, and \$remove properties.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove from Profile List Property
>
> **Slug:** `MIXPANEL_REMOVE_FROM_LIST_PROPERTY`
>
> Tool to remove values from list properties on user profiles in Mixpanel using the \$remove operation. Use when you need to remove specific items from list-type properties. If the value doesn't exist in the list, no action is taken. The profile will be created if it doesn't exist.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address for geolocation enrichment. Set to '0' to prevent updating geolocation data. If not provided, Mixpanel uses the request IP. Geolocation properties (\$city, \$region, mp\_country\_code) are derived and the IP is discarded.
>
> **time** `integer`
>
> Unix timestamp (seconds since epoch) indicating when the profile update occurred. Defaults to the current server time if not provided.
>
> **token** `string` *required*
>
> Your Mixpanel project authentication token. Required for authenticating the request.
>
> **distinct\_id** `string` *required*
>
> The unique identifier for the user profile to update. This determines which profile will be modified.
>
> **ignore\_time** `boolean`
>
> If true, prevents Mixpanel from automatically updating the 'Last Seen' property. Defaults to false.
>
> **remove\_properties** `object` *required*
>
> A dictionary of list properties and values to remove. Each key is a property name and each value is the item to remove from that list property. If the value doesn't exist in the list, no action is taken.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Service Accounts From Projects
>
> **Slug:** `MIXPANEL_REMOVE_SERVICE_ACCOUNTS_FROM_PROJECTS`
>
> Remove service accounts from the specified projects in an organization. Supply each project ID with its list of service account IDs to remove. This removes project membership without deleting the service accounts.
>
> #### Input Parameters
>
> **projects** `array` *required*
>
> Projects and the service accounts to remove from each.
>
> **organization\_id** `integer` *required*
>
> Organization containing the projects and service accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Replace Lookup Table
>
> **Slug:** `MIXPANEL_REPLACE_LOOKUP_TABLE`
>
> Replace all records in an existing Mixpanel lookup table with inline CSV. This overwrites the table's contents, rather than appending rows. Obtain its UUID from Lexicon or List Lookup Tables. Uses service-account or project-secret Basic authentication against the project's regional ingestion host.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the existing lookup table, available in Lexicon's table details.
>
> **csv\_data** `string` *required*
>
> Complete replacement table as inline CSV text, including the header row and primary-key column. Sent verbatim as UTF-8 text/csv, not a file URL. Example: id,field1,field2 key1,v1,z1 key2,z1,z2
>
> **project\_id** `string` *required*
>
> Mixpanel project\_id used to authenticate service account credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Insights Query
>
> **Slug:** `MIXPANEL_RUN_INSIGHTS_QUERY`
>
> Run an ad hoc Insights query with event, funnel, retention, cohort or formula metrics. Supports filters, breakdowns and comparisons without requiring a saved report. Requires Query API access on the project's plan; HTTP 402 indicates a plan gate.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Complete InsightsQueryRequest JSON body; omitted optional keys remain absent and explicit nulls are preserved.
>
> **project\_id** `integer` *required*
>
> Project ID to query, in the connection's region.
>
> **workspace\_id** `integer`
>
> Workspace ID, if applicable.
>
> **mixpanel\_version** `string`
>
> Mixpanel-Version release date and optional preview channel; defaults to documented Insights beta version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Warehouse Import
>
> **Slug:** `MIXPANEL_RUN_WAREHOUSE_IMPORT`
>
> Trigger an immediate sync for an existing warehouse import. Returns the sync run identifier when supplied by Mixpanel. This starts the sync; it does not wait for ingestion to finish.
>
> #### Input Parameters
>
> **body** `string`
>
> Required JSON body. The provider documents no schema or options; defaults to an empty object.
>
> **import\_id** `integer` *required*
>
> Warehouse import ID to sync now.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Numeric Bucket Segmentation Query
>
> **Slug:** `MIXPANEL_SEGMENTATION_NUMERIC_QUERY`
>
> Tool to get event data numerically bucketed by property values. Use when you need to analyze distributions of numeric properties like revenue, session duration, or counts with automatic bucketing.
>
> #### Input Parameters
>
> **on** `string` *required*
>
> The numeric property expression to bucket by. Use format like 'number(property\_name)' or numeric expressions
>
> **type** `string ("general" | "unique" | "average")`
>
> Analysis types for Mixpanel event aggregation.
>
> **unit** `string ("hour" | "day" | "week" | "month")`
>
> Longer time units for certain analytics.
>
> **event** `string` *required*
>
> The event name to get data for
>
> **where** `string`
>
> An expression to filter events by (e.g., 'properties\["country"] == "US"')
>
> **to\_date** `string` *required*
>
> The date in yyyy-mm-dd format to query to (inclusive)
>
> **from\_date** `string` *required*
>
> The date in yyyy-mm-dd format to begin querying from (inclusive)
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **bucket\_size** `integer`
>
> Size of numeric buckets for grouping values. If not specified, Mixpanel will automatically determine bucket size
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Group Property Once
>
> **Slug:** `MIXPANEL_SET_GROUP_PROPERTY_ONCE`
>
> Tool to set properties on a Mixpanel group profile only if they don't already exist. Use when you need to set initial properties for a group without overwriting existing values. Ideal for setting default values or tracking when a group was first created. Properties that already exist will not be modified.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> Project authentication token for Mixpanel API authentication
>
> **group\_id** `string` *required*
>
> Unique identifier for the specific group instance
>
> **group\_key** `string` *required*
>
> Group type identifier (e.g., 'Company', 'Organization', 'Team'). This defines the category of the group.
>
> **properties** `object` *required*
>
> Key-value pairs of properties to set on the group profile. Properties will only be set if they don't already exist on the group.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Profile Property Once
>
> **Slug:** `MIXPANEL_SET_PROFILE_PROPERTY_ONCE`
>
> Tool to set user profile properties in Mixpanel using the \$set\_once operation. Use when you need to set properties that should only be recorded on their initial value. Properties specified will be created only if they don't already exist on the profile. If a property already has a value, it will not be overwritten. Ideal for tracking first-time values like signup source, initial referrer, or first login date.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address for geolocation enrichment. Set to '0' to prevent updating geolocation data. If not provided, Mixpanel uses the request IP. Geolocation properties (\$city, \$region, mp\_country\_code) are derived and the IP is discarded.
>
> **time** `integer`
>
> Unix timestamp (seconds since epoch) indicating when the profile update occurred. Defaults to the current server time if not provided.
>
> **token** `string` *required*
>
> Your Mixpanel project authentication token. Required for authenticating the request.
>
> **distinct\_id** `string` *required*
>
> The unique identifier for the user profile to update. This determines which profile will be modified.
>
> **ignore\_time** `boolean`
>
> If true, prevents Mixpanel from automatically updating the 'Last Seen' property. Defaults to false.
>
> **set\_once\_properties** `object` *required*
>
> A dictionary of properties to set on the user profile only if they don't already exist. If a property already has a value, it will not be overwritten. Useful for tracking initial values like 'First Login', 'Signup Source', 'Initial Referrer', etc.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Today's Top Events (Deprecated)
>
> **Slug:** `MIXPANEL_TODAYS_TOP_EVENTS`
>
> DEPRECATED: Use MIXPANEL\_QUERY\_TOP\_EVENTS instead. Get the top events for today, with their counts and the normalized percent change from yesterday. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **type** `string ("general" | "unique" | "average")` *required*
>
> The analysis type you would like to get data for - such as general, unique, or average events
>
> **limit** `integer`
>
> The maximum number of events to return
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Top Event Properties
>
> **Slug:** `MIXPANEL_TOP_EVENT_PROPERTIES`
>
> Get the top property names for an event. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **event** `string` *required*
>
> The event that you wish to get data for. Note: this is a single event name, not an array
>
> **limit** `integer`
>
> The maximum number of properties to return
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Top Event Property Values
>
> **Slug:** `MIXPANEL_TOP_EVENT_PROPERTY_VALUES`
>
> Tool to get the top values for a property ordered by frequency. Use when you need to understand the most common values for a specific property on an event. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries. This limit is shared across all Query API tools (e.g., MIXPANEL\_QUERY\_SEGMENTATION); on a 429 response, apply exponential backoff.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the property you would like to get data for
>
> **event** `string` *required*
>
> The event that you wish to get data for. Note: this is a single event name, not an array
>
> **limit** `integer`
>
> The maximum number of values to return
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Top Events
>
> **Slug:** `MIXPANEL_TOP_EVENTS`
>
> Get a list of the most common events over the last 31 days. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.
>
> #### Input Parameters
>
> **type** `string ("general" | "unique" | "average")` *required*
>
> The analysis type you would like to get data for - such as general, unique, or average events
>
> **limit** `integer`
>
> The maximum number of values to return
>
> **project\_id** `integer` *required*
>
> Required if using service account to authenticate request
>
> **workspace\_id** `integer`
>
> The id of the workspace if applicable
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unarchive Experiment
>
> **Slug:** `MIXPANEL_UNARCHIVE_EXPERIMENT`
>
> Unarchive an experiment in a Mixpanel workspace and return the updated experiment. Requires a service account with access to the workspace.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment to unarchive.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to unarchive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Annotation
>
> **Slug:** `MIXPANEL_UPDATE_ANNOTATION`
>
> Update an existing Mixpanel annotation's description and/or tag IDs. Requires a role of at least Analyst. Returns the annotation, including its date, creator, and tags. Omitted fields are not sent to the provider.
>
> #### Input Parameters
>
> **tags** `array`
>
> IDs of existing tags to add to the annotation.
>
> **project\_id** `integer` *required*
>
> Project containing the annotation.
>
> **description** `string`
>
> Text shown when looking at the annotation.
>
> **annotation\_id** `string` *required*
>
> Numeric ID of the annotation to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Experiment
>
> **Slug:** `MIXPANEL_UPDATE_EXPERIMENT`
>
> Update an existing Mixpanel workspace experiment's fields, settings, variants, metrics, caches, dates, tags, or visibility. Only supplied fields are sent; explicit null values are preserved. Requires a service account with workspace access.
>
> #### Input Parameters
>
> **name** `string`
>
> New experiment name (1–255 characters).
>
> **tags** `array`
>
> Experiment tags.
>
> **status** `string`
>
> Experiment status; the update API does not enumerate values.
>
> **metrics** `array`
>
> Experiment metrics; the API does not define an item schema.
>
> **end\_date** `string`
>
> Experiment end date string.
>
> **settings** `object`
>
> Experiment settings; the API defines no fixed object schema.
>
> **variants** `array`
>
> Experiment variants; the API does not define an item schema.
>
> **hypothesis** `string`
>
> Hypothesis being tested by the experiment.
>
> **start\_date** `string`
>
> Experiment start date string.
>
> **description** `string`
>
> Experiment description (up to 400 characters).
>
> **workspace\_id** `integer` *required*
>
> Workspace containing the experiment.
>
> **experiment\_id** `string` *required*
>
> ID of the experiment to update.
>
> **results\_cache** `object`
>
> Cached results; the API defines no fixed object schema.
>
> **exposures\_cache** `object`
>
> Cached exposure counts; the API defines no fixed object schema.
>
> **global\_access\_type** `string`
>
> Global access type; the API does not enumerate values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Feature Flag
>
> **Slug:** `MIXPANEL_UPDATE_FEATURE_FLAG`
>
> Update a feature flag with its complete configuration in a project workspace. Supply the required name, key, tags, context, serving method and ruleset; this PUT operation is not a partial patch. Uses Mixpanel's regional application API and service-account authentication. Returns the complete provider response for the updated flag.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Complete feature flag update payload, not a partial patch.
>
> **flag\_id** `string` *required*
>
> Feature flag ID in the URL path.
>
> **project\_id** `integer` *required*
>
> Project ID in the URL path.
>
> **workspace\_id** `integer` *required*
>
> Workspace ID in the URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Union to Group List Property
>
> **Slug:** `MIXPANEL_UPDATE_GROUP_LIST_PROPERTY`
>
> Tool to add unique values to list properties on group profiles in Mixpanel. Use when you need to add items to list-type group properties without creating duplicates. The \$union operation ensures that values are only added if they don't already exist in the list.
>
> #### Input Parameters
>
> **ip** `integer`
>
> Controls geolocation parsing. Set to 0 to disable, 1 to enable. If not provided, defaults to request IP.
>
> **data** `array` *required*
>
> A list of group union update objects. Each object must contain \$token, \$group\_key, \$group\_id, and \$union properties.
>
> **strict** `integer`
>
> Enables validation with error messages. Set to 1 to enable strict mode, 0 to disable.
>
> **verbose** `integer`
>
> Returns detailed operation success/failure information. Set to 1 for detailed response, 0 for simple response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Warehouse Import
>
> **Slug:** `MIXPANEL_UPDATE_WAREHOUSE_IMPORT`
>
> Pause or resume an existing warehouse import and set its sync frequency. Optionally replace the complete Databricks cluster configuration. Resuming permits ingestion to continue; pausing stops the job and future syncs.
>
> #### Input Parameters
>
> **paused** `boolean` *required*
>
> True stops the import job and new syncs; false resumes it.
>
> **import\_id** `integer` *required*
>
> Existing warehouse import ID.
>
> **run\_every** `integer ("0" | "3600000000000" | "86400000000000" | "604800000000000")` *required*
>
> Required sync frequency in nanoseconds: 0 (API only), 3600000000000 (hourly), 86400000000000 (daily), or 604800000000000 (weekly).
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID.
>
> **databricks\_params** `object`
>
> Databricks-only cluster settings, or null. This fully replaces the configuration, rather than merging it; provide the complete desired export\_cluster\_config.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert Schema
>
> **Slug:** `MIXPANEL_UPSERT_SCHEMA`
>
> Create or replace one event or profile Lexicon schema in a project. Requires a service account with project access. Replaces the existing schema matching the entity type and name. Sends the supplied schema JSON directly, including its properties and metadata.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Entity name, such as an event name.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID whose schema to upload.
>
> **entity\_type** `string ("event" | "profile")` *required*
>
> Entity type described by this schema: event or profile.
>
> **schema\_json** `object` *required*
>
> Entity JSON Schema sent directly as the request body. May contain description, properties, metadata, and arbitrary JSON Schema keywords or metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert Schemas
>
> **Slug:** `MIXPANEL_UPSERT_SCHEMAS`
>
> Create or replace multiple event or profile Lexicon schemas in a project. Requires a service account with project access. Existing schemas with matching entity types and names are replaced. Setting truncate=true deletes the entire data dictionary before inserting the supplied entries.
>
> #### Input Parameters
>
> **entries** `array` *required*
>
> Schema entries to create or replace in the project's Lexicon.
>
> **truncate** `boolean`
>
> If true, delete the entire data dictionary before inserting entries.
>
> **project\_id** `integer` *required*
>
> Mixpanel project ID whose schemas to upload.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
