# Mixpanel

**Where to find it:** Apps → Mixpanel **Who can access it:** Admins **Category:** Product analytics

***

#### What it does

The Mixpanel integration pulls product usage events and user data from Mixpanel into Startdeliver. Once connected, Mixpanel events feed directly into product usage health — giving the AI a continuous signal on how your customers are actually using your product without your team having to manually track or import anything.

The integration supports two sync types that can be enabled independently: syncing customers and users from Mixpanel, and syncing usage events from Mixpanel. Most teams enable both.

***

#### What syncs

**Usage events** Mixpanel events sync into Startdeliver as usage data, feeding product usage health per customer. You control which events sync — either all events, or a specific list. These events are matched to products and usage types configured in Settings → Products.

**Customers and users** Mixpanel user profiles can sync into Startdeliver as users on the matched customer record. Matching is done via a Startdeliver user field you define — typically email address.

***

<figure><img src="/files/MPbIZo88dCqeVfx4iMjO" alt=""><figcaption></figcaption></figure>

#### Setup

1. Go to Apps → Mixpanel
2. Enter your **Mixpanel API secret** — found in your Mixpanel project settings under Service Accounts or API Access
3. Configure the settings below
4. Click Save

***

#### Settings

**Do you store your customers' personal data in Europe?** Select Yes if your Mixpanel project stores data in the EU data center. If unsure, select No. This affects which Mixpanel API endpoint the integration uses and must be set correctly for data to flow.

**Are you using a Service Account for authentication?** Select Yes if you are authenticating via a Mixpanel Service Account rather than the legacy API secret. Service Accounts are the recommended authentication method for newer Mixpanel projects.

**Enter which events to sync** Specify which Mixpanel events should be pulled into Startdeliver. Enter event names comma-separated — for example: `Logged In,Created Dashboard,Exported Report`. Leave this field empty to sync all events from your Mixpanel project. Syncing all events is a good starting point — you can narrow it down once you know which events matter for health scoring.

**Do you wish to use a Filter when fetching events?** Enable this to apply a filter expression when fetching events from Mixpanel. Useful for excluding internal test events, bot traffic, or events from specific user segments you don't want included in health calculations.

**Do you want to sync customers and users from Mixpanel?** When enabled, Mixpanel user profiles sync into Startdeliver as users on the matched customer record. Requires the matching field configuration below.

**Do you want to sync events from Mixpanel?** When enabled, Mixpanel events sync into Startdeliver as usage data, feeding product usage health. This is the primary reason most teams connect Mixpanel.

**Startdeliver user field to match users on** Select the Startdeliver user field used to match incoming Mixpanel users to existing Startdeliver user records. Typically email address. This field must exist as a custom field on the user object in Startdeliver and must contain the same value that Mixpanel holds for each user.

**(Optional) Startdeliver user field to override for events** By default, Mixpanel events are matched to users using the same field as the user sync. Enable this if you want to match events on a different field — for example, if user profiles sync via email but your Mixpanel events are tagged with a numeric user ID stored in a separate Startdeliver field. Leave empty to use the same matching field for both users and events.

***

#### How Mixpanel events feed health

Once events are flowing, they need to be connected to products in Startdeliver to affect health scoring. Go to Settings → Products, open a product, and go to the Usage Types tab. Attach the relevant Mixpanel event names as usage types. The product health model then scores each customer based on how frequently those events occur relative to the goals you've configured.

→ [Product usage health](/health-and-metrics/product-usage-health.md)

***

#### Troubleshooting

**Events not appearing in Startdeliver** Confirm the API secret is correct and matches the project you want to sync from. Check whether you're using a Service Account — if yes, ensure the Service Account toggle is set to Yes. If you've specified event names to sync, confirm the names match exactly as they appear in Mixpanel (case-sensitive). Check the EU data storage setting — if your Mixpanel data is in the EU and this is set to No, the integration will query the wrong endpoint and return no data.

**Users not matching to Startdeliver records** Check the matching field — the value in Mixpanel's user profile for that field must exactly match the value in the corresponding Startdeliver user field. If users exist in Mixpanel but not in Startdeliver, they won't be created unless user sync is enabled. Confirm "Do you want to sync customers and users from Mixpanel?" is set to Yes.

**Events syncing but health not updating** Events must be attached to a product as usage types before they affect health. Go to Settings → Products, open the relevant product, and check the Usage Types tab — confirm the event names are attached. Also check the product's goal type and targets are configured correctly.

**Event matching using a different identifier** If your Mixpanel events use a different user identifier than your user profiles (for example, a numeric ID rather than email), use the optional override field to specify the Startdeliver field that holds the matching value for events specifically.

***

Ready to move on to the next integration or use case?


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.startdeliver.io/integrations-and-your-stack/other-apps/mixpanel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.