Ctrlk
MESA Homepage
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Mixpanel

Connection

When you're setting up your first workflow with Mixpanel, you will need to create a Connection in order to connect MESA with Mixpanel.

Screenshot of the Mixpanel step in the MESA workflow builder prompting you to create a Connection. Spotlight the Add connection button.

To create a Mixpanel connection, you'll need to create a service account that has the Owner or Admin role where you can create and add your Service Account Username and Service Account Secret. You can learn more about service accounts here.

To create a Service Account, login into Mixpanel and navigate to the Organization Settings.

Screenshot of the Mixpanel dashboard after logging in. Spotlight the Organization Settings navigation.

Next, open the Service Accounts menu and click the Add Service Account button:

Screenshot of the Mixpanel Organization Settings with the Service Accounts menu open. Spotlight the Add Service Account button.

Add a name for your Service Account and and be sure to set the Organizational role and Project roles to Owner or Admin. Otherwise, you will not be able to successfully connect your connection. Then click Create.

Screenshot of the Mixpanel Add Service Account dialog with a name entered. Spotlight the Organizational role and Project roles set to Owner or Admin, then Create.

Next, copy the Username and paste it in the Service Account Username field of your Mixpanel step in MESA. Additionally, copy the Secret and paste it in the Service Account Secret field of your Mixpanel step in MESA. Afterwards, click Done to complete the creation process.

Screenshot of the Mixpanel Service Account created dialog showing the Username and Secret. Spotlight the Username and Secret values to copy before clicking Done.

The Service Account Secret can only be viewed and copied during the creation process. Be sure to save it if you will need to reference it in the future.

Next, from your Mixpanel Settings, open the Project tab and copy your Project Token in the Access Keys section. Then, paste it in the Project Token field of your Mixpanel step in MESA. Then, click the Add connection button.

Screenshot of the Mixpanel connection setup in MESA with the Service Account Username, Secret, and Project Token fields filled in. Spotlight the Add connection button.

Some actions will require your Project ID instead of the Project Token. Be sure to identify the correct one via the required fields in your step's connection setup and paste the correct value.

You should now see your new connection added to the dropdown when the step updates.

Screenshot of the Mixpanel step in the MESA workflow builder after adding the connection. Spotlight the connection dropdown showing the new connection.

Configure

Create an Event

Event Name

For the Event Name field, use the table name as the Event Name if pulling from a data warehouse.

Try to limit the amount of event names you have and use properties for details—e.g., track a single “Signup” event with an “Account Type” property set to “paid” or “free” instead of separate “Paid Signup” and “Free Signup” events.

Distinct ID

This value should be the unique ID of the user you're referencing—e.g., a Shopify Customer ID.

Technical Notes

  • If you have multiple Mixpanel projects, you will need to create a Mixpanel connection for each project.

  • Actions that query for data have a rate limit of 60 queries per hour and a maximum of 5 concurrent queries. We recommend to run these steps on a scheduled basis (Schedule tool) to ensure that you do not query more than 60 times an hour. Do not run a Time Travel using these steps.

  • Profile steps will not error if there are issues with the information sent to Mixpanel.

  • Variables for User Profile's properties will not display because they are flexible and vary. If you need help, we recommend contacting support for help with creating variables.

PreviousMantle
NextNotion

Last updated