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

# Mixpanel App

> Install the official Mixpanel app to send payment, subscription, refund, and dispute events from Dodo Payments to Mixpanel. Connect with a service account and choose the events.

## What the Mixpanel app does

The Mixpanel app sends events from your business to your Mixpanel project. Each event has a name like `dodo_payment_succeeded`. You can use the events in reports and funnels.

## Before you start

* You are an owner or an admin of the Dodo Payments business.
* You have a Mixpanel project, its project ID, and a service account that can send data to it. In the Connect dialog, select **Where do I find this?** to see where to find each value.
* You know the data residency of the project: US, EU, or India.

## Install, connect, and configure

**1. Install the app**

Open **Apps**, then **Explore**. Open **Mixpanel** (publisher **Dodo Payments**) and select **Install**.

![The Mixpanel app page in the marketplace with the Official badge and the Install button](https://mintcdn.com/dodopayments/kJYllb8bAFUjIS_F/images/app-marketplace/merchant/18-mixpanel-app-page.png?fit=max\&auto=format\&n=kJYllb8bAFUjIS_F\&q=85\&s=e13323b0017544a2ddfee50e7f9c07d1)

**2. Connect Mixpanel**

Select **Connect**. Enter the **Service Account Username** and the **Service Account Secret**, then select **Connect**. Dodo Payments tests them.

![The Connect Mixpanel dialog with the service account credential fields](https://mintcdn.com/dodopayments/kJYllb8bAFUjIS_F/images/app-marketplace/merchant/19-mixpanel-connect-dialog.png?fit=max\&auto=format\&n=kJYllb8bAFUjIS_F\&q=85\&s=c934577368b147f7c48693bd0c9f8f09)

If Mixpanel refuses them, the dialog says "The credentials are not correct. Enter correct credentials and try again."

**3. Set the project and the events**

Open the **Configure** tab. Enter the **Mixpanel project ID**, select the **Mixpanel data residency**, choose the events, and select **Save**. The project ID and the residency are required. The Configure tab shows **Action needed** until both have a value.

![The Configure tab of the Mixpanel app with the project ID, the data residency, the event switches, and the filters](https://mintcdn.com/dodopayments/kJYllb8bAFUjIS_F/images/app-marketplace/merchant/20-mixpanel-configure.png?fit=max\&auto=format\&n=kJYllb8bAFUjIS_F\&q=85\&s=af929f5082fa3995f849d36f3a829533)

## Settings

| Setting | What it does | Default |
| - | - | - |
| Mixpanel project ID | The project that gets the events. Required. | Empty |
| Mixpanel data residency | **US**, **EU**, or **India**. Required. | US |
| Send payment events | Send payment events. | On |
| Send subscription events | Send subscription events. | On |
| Send refund events | Send refund events. | Off |
| Send dispute events | Send dispute events. | Off |
| Mixpanel distinct ID | **Customer email**, **Dodo customer ID**, or **Metadata key**. | Customer email |
| Metadata key for the distinct ID | The customer metadata key to use when you select **Metadata key**. | Empty |
| Products, Currencies | Send events only for the products or currencies that you pick. | All |
| Minimum amount | Skip events with a smaller amount. | No minimum |

> [!WARNING]
>
> Select the same data residency as your Mixpanel project. With the wrong residency, the events do not arrive.

## What is sent and when

Dodo Payments sends one Mixpanel event for each Dodo Payments event, after the event happens. The event name starts with `dodo_`. The event properties do not contain card data, the address, or the customer name. With the default setting, the customer email is the distinct ID. Amounts go out in the major unit with the currency code.

## Test the app

**1. Use test mode**

Install and connect the app in test mode. Enter the project ID and the residency, and save.

**2. Make a test payment**

Create a test payment.

**3. Check Mixpanel**

Open the event view of your project. A `dodo_payment_succeeded` event appears.

## Troubleshooting

| Problem | What to do |
| - | - |
| "The credentials are not correct" | Create the service account again in Mixpanel and enter the new credentials. |
| The warning "Dodo Payments could not check this key" | The connection is saved. If no events arrive, select **Update connection** and enter the credentials again. |
| **Action needed** on the Configure tab | Enter the project ID and the residency, then save. |
| No events arrive | Check the residency, the project ID, the event switches, and the filters. |
| **Connection needs attention** | Mixpanel stopped accepting the credentials. Select **Reconnect**. |

## Disconnect and uninstall

Turn off the events on the **Configure** tab to stop sending data. Uninstall the app to delete the connection. See [Manage and uninstall](https://docs.dodopayments.com/features/app-marketplace/manage-and-uninstall.md).


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