Mixpanel helps companies measure what matters, make decisions fast, and build better products through data. With our powerful, self-serve product analytics solution, teams can easily analyze how and why people engage, convert, and retain—in real-time, across devices—to improve their user experience.

Authenticating

Mixpanel uses OAuth, a developer-friendly delegated access protocol. Quolum has already connected the necessary wires with Mixpanel. Using a sequence of click-throughs, your organization's administrator allows Quolum to make API calls to Mixpanel without getting access to passwords.

Step 1: Initiate a connection to Mixpanel

Click the Connect button from the Connections card. If you are not an admin, you can invite your organization's Mixpanel admin to make a connection to your Mixpanel organization account. When you click on the Connect button, the web browser will navigate to the Mixpanel login page.

Step 2: Log in to Mixpanel

Log in to Mixpanel using your organization's credentials. The exact login mechanism may depend on your Mixpanel plan, and the sign-in mechanism used. You may have corporate SSO such as Azure AD, GSuite, or Okta along with multi-factor authentication. You need to enter a Service Account Username and Service Account secret, the step by step details of which can be found at Step 3 below. Once you have successfully logged-in, Mixpanel is going to ask you to grant access to Quolum.

Step 3: Finding Mixpanel "Service Account Username" and "Service Account Secret"

• Log in to your Mixpanel account and navigate to the "Organizational Settings" section in the top right corner of the screen.

• Click on "Service Accounts" from the left nav bar.

• If you have previously created a service account, you should see it listed here. Click on the service account name to view its details. Note: Unless you have noted your service account secret somewhere before, you cannot use this service account. you need to create a new service account to get a new service account secret.
• To create a new service account, click on the "New Service Account" button.
• Choose "Organization Service Account" as the type of service account you want to create.
• Under the "Credentials" section, you will see the service account username and service account secret. You can choose to generate a new secret by clicking the "Generate" button. Make sure to select the role as "Admin" or "Owner" and select the projects for which you want to track utilization in Quolum
• Choose the appropriate access level for your organization service account.
• Click "Create Service Account" to complete the process.

• Under the "Credentials" section, you will see the service account username and service account secret.
• Copy these and paste into Quolum

Step 4: Provide consent to Quolum

The next screen after login into Mixpanel is the consent screen. On this screen, Mixpanel confirms whether you authorize Quolum to access your organization's data.

Step 5: Back to Quolum

Once you have granted access to Quolum on Mixpanel's website, Mixpanel is going to send you back to Quolum's page in Step 1, where you started. The Connect button on the Connections card would now say Reconnect. Reconnect is used to reauthenticate under circumstances where the access has expired.

Under the hood

Using the OAuth protocol, Quolum now has delegated access to your Mixpanel Workspace. The Quolum server, running on Amazon AWS VPC, will be able to make API calls and retrieve feature-level utilization of projects, stories, and tasks. Later, this data is crunched and available for visualization on the Quolum dashboard.