# Integrate Mixpanel with Databox Mixpanel is a product analytics platform that helps businesses understand how users interact with their digital products. It tracks events, user journeys, funnel conversions, and retention patterns across web and mobile applications, enabling product and growth teams to make data-driven decisions. Connecting Mixpanel to Databox brings your product analytics alongside data from other tools, so you can monitor user engagement, measure feature adoption, and track conversion performance in a unified view. ## Connection ### Before you begin Mixpanel supports two authentication methods when connecting to Databox: Service Account authentication and Project Secret authentication. Service Account is the recommended method. ### Option 1: Connect with a Service Account (recommended) Use this method for all new connections. Service Accounts are the authentication mechanism recommended by Mixpanel going forward and are required when using Mixpanel's Group Analytics. 1. In Mixpanel, go to **Settings > Project Settings > Service Accounts**. If no service account exists, click **Add Service Account** to create one. Save the **Username** and **Secret** that are generated — the secret is only shown once. 2. In Databox, enter a name for the connection in the **Data source name** field. 3. Check the **Service Account Authentication** checkbox. 4. Enter the service account username in the **Service Account Username** field. 5. Enter the service account secret in the **API Secret / Service Account Secret** field. 6. Find your **Project ID** in Mixpanel under **Settings > Project Settings > Project ID** and enter it in the **Project ID** field. 7. If you use Mixpanel's Group Analytics, enter one or more **Data Group IDs** (comma-separated) in the **Group Keys (Data Group IDs)** field. Find these in Mixpanel under **Settings > Project Settings > Group Keys**. This makes Group Analytics data available in datasets. 8. Click **Connect**. connect-mixpanel-service-account ### Option 2: Connect with a Project Secret The **API Secret / Service Account Secret** field in Databox accepts Mixpanel's Project Secret when Service Account Authentication is unchecked. Use this only if you have an existing connection that relies on it. Mixpanel has deprecated the Project Secret. This authentication method will be fully retired on **March 3, 2027**. Migrate to a Service Account to avoid a connection disruption. 1. In Mixpanel, go to **Account Information > Projects** and locate your **Project Secret**. 2. In Databox, enter a name for the connection in the **Data source name** field. 3. Leave the **Service Account Authentication** checkbox unchecked. 4. Paste your Project Secret into the **API Secret / Service Account Secret** field. 5. If your Mixpanel project is hosted in the EU data center, check the **EU-based project** checkbox. 6. Click **Connect**. connect-mixpanel-project-secret ## Metric Builder The Mixpanel integration allows you to create custom metrics using the metric builder, ideal for visualizing data not included in the basic metrics offered by the integration. metric-builder To create a custom metric, select one of the five query types — **Explore**, **Funnels**, **Multisegmentation**, **Retention**, or **Segmentation** — and configure the available options. Each query type exposes different selectors and filters based on the kind of analysis you want to perform. The query types available for metric creation are listed below. ### Explore The Explore query type queries Mixpanel People (Engage) data — user profile records stored in Mixpanel. Use it to filter a user population by their properties and optionally aggregate a metric across the filtered set. Add one or more filter conditions in the **Filters** section by selecting a property, its type (String, Boolean, Number, or Date), and an operator. Available operators depend on the selected type — for example, string properties support Equals, Contains, and Is set, while date properties let you filter relative to the current time. Expand **Optional parameters** to select a **Metric**, **Metric operation**, and **Dimension**. **In Mixpanel:** Go to **Users** to browse available people properties before building your query. ### Funnels The Funnels query type measures conversion rates across a sequence of events. Use it to track how many users complete each step of a defined funnel and identify where drop-offs occur. Select the **Funnel** you want to measure from the funnel selector, then choose the **Funnel data type**: **Counts (daily)**, **Overall conversion ratio**, or **Step conversion ratio**. **In Mixpanel:** Go to **Reports > Funnels** to find and review your saved funnels. The funnel name shown there is what appears in the selector. ### Multisegmentation The Multisegmentation query type lets you build composite event metrics by combining multiple aggregation operations. Use it when you need to calculate values that require both an inner aggregation (e.g., averaging a property per event) and an outer grouping (e.g., summing across a dimension). Add one or more filter rows using the **+** button. Each row defines an **Inner operation** (e.g., AVG, SUM), an **Inner dimension**, an **Outer operation** (e.g., BY), and an **Outer dimension**. Use the **Filters** (Where) section to apply additional property-level filters to the query. **In Mixpanel:** Go to **Reports > Insights** and apply multiple breakdowns to explore the events and dimensions available for multisegmentation queries. ### Retention The Retention query type measures how often users return to perform an event after an initial action. Use it to track user retention curves and understand long-term engagement patterns. Select the **Event** you want to segment on using the event selector. Choose whether to display results as **Counts** or **Percentages** using the **Push values** dropdown. **In Mixpanel:** Go to **Reports > Retention** to review your retention reports and identify the event you want to track. ### Segmentation The Segmentation query type lets you measure a specific event metric with optional dimension breakdown and property filtering. Use it to track totals, averages, or unique counts for any event, optionally split by a dimension. Select the **Metric (Event)** and choose a **Metric operation** of **Count** or **SUM**. Optionally enter a **Dimension** and set the **Dimension Type** (Boolean, Date, Number, or String). Add one or more filter conditions in the **Query Filters** section using the **Where** rows and the **+** button. Select the aggregation **Type**: **Average**, **Total**, or **Unique**. Expand the **Advanced** section to optionally enable **Push timestamp instead of value**. **In Mixpanel:** Go to **Reports > Insights** to explore events, their properties, and segmentation breakdowns before building your metric. ## ![lock](/assets/lock.2fb1bbc208afcc03d15a0a45f22bdf7f830322016e038e5721965851130807af.419bb737.svg) Datasets The Mixpanel integration supports [datasets](/understanding-datasets). When you connect using Service Account authentication and provide one or more **Group Keys (Data Group IDs)**, Mixpanel Group Analytics data becomes available for use in datasets. Each Data Group ID corresponds to a group type defined in your Mixpanel project (e.g., Company, Account) and allows you to build datasets that aggregate data at the group level rather than the individual user level. ## Resources For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below. Project Secret authentication uses a project-level credential, while Service Account authentication is the recommended method going forward — it supports broader project access and is required when using Mixpanel Group Analytics data in datasets.   Ask Genie Get instant answers or help with your data using the in-app AI assistant. Talk to an expert For customers: Get help with your setup, strategy, or making the most of Databox. Book a demo New to Databox? See how it works and get guidance on getting started. Send an email Reach out to support for help with your account, data, or technical issues.