Connect AI agents to Mixpanel Compliance

Setup

1. Install the SDK

   • Node.js
   • Python

   npm install @scalekit-sdk/node dotenv

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Create the Mixpanel Compliance connection

   In AgentKit > Connections, create a Mixpanel Compliance connection. The name you give it is the connection_name your code passes. See Configure connections.

   Console steps with screenshots

   Register your Mixpanel GDPR/CCPA compliance token with Scalekit so it can authenticate and proxy data deletion and retrieval requests on behalf of your users. This connector uses a Bearer token.

   1. Find your Mixpanel data residency region

      Mixpanel hosts projects in three separate data residency regions. Before generating a token, confirm which region your project lives in:

      Region	API host
      United States (default)	mixpanel.com/api
      European Union	eu.mixpanel.com/api
      India	in.mixpanel.com/api

   2. Get your GDPR compliance token

      • Sign in to Mixpanel and go to Settings → Profile → Data & Privacy.

      • Under GDPR API, copy the OAuth Token for GDPR APIs. If none exists yet, click Reset to generate one.

        

   3. Create a connection in Scalekit

      • In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
      • Search for Mixpanel Compliance and click Create.
      • Note the Connection name — use this as connection_name in your code (e.g., mixpanelcompliance).

   4. Add a connected account

      Connected accounts link a specific user identifier in your system to a GDPR compliance token and region. Add one in the dashboard to test. In production, each user adds their own through the authorization link: they enter their credentials on the page it opens.

      In the dashboard, to test

      • Open the connection and click the Connected Accounts tab → Add account.
      • Fill in Your User’s ID, the GDPR Token, and select the matching Data Residency.
      • Click Save.

      From your backend, if your app already has the credentials

      For example, when users enter them on a settings page in your app:

      • Node.js
      • Python

      1
      import { ConnectorStatus } from '@scalekit-sdk/node'
      2
      
      3
      // Upsert the account, then make sure it is ACTIVE before the first tool call.
      4
      async function connectUser(connectionName, identifier, details) {
      5
        const authorizationDetails = { details: { case: 'staticAuth', value: { details } } }
      6
        let { connectedAccount } = await scalekit.actions.upsertConnectedAccount({
      7
          connectionName,
      8
          identifier,
      9
          authorizationDetails,
      10
        })
      11
        if (connectedAccount?.status !== ConnectorStatus.ACTIVE) {
      12
          ;({ connectedAccount } = await scalekit.actions.upsertConnectedAccount({
      13
            connectionName,
      14
            identifier,
      15
            authorizationDetails,
      16
          }))
      17
        }
      18
        return connectedAccount
      19
      }
      20
      
      21
      // US region (default) — omit `domain` or set it to 'mixpanel.com/api'
      22
      await connectUser('mixpanelcompliance', 'user_123', {
      23
        token: 'your-gdpr-compliance-token',
      24
        domain: 'mixpanel.com/api',
      25
      })
      26
      
      27
      // EU region
      28
      await connectUser('mixpanelcompliance', 'user_123', {
      29
        token: 'your-eu-gdpr-compliance-token',
      30
        domain: 'eu.mixpanel.com/api',
      31
      })

4. Authorize a user and make your first call

   • Node.js
   • Python

   1
   import { ScalekitClient } from '@scalekit-sdk/node'
   2
   import 'dotenv/config'
   3
   import { createInterface } from 'node:readline/promises'
   4
   
   5
   const scalekit = new ScalekitClient(
   6
     process.env.SCALEKIT_ENVIRONMENT_URL,
   7
     process.env.SCALEKIT_CLIENT_ID,
   8
     process.env.SCALEKIT_CLIENT_SECRET,
   9
   )
   10
   const actions = scalekit.actions
   11
   
   12
   const connector = 'mixpanelcompliance'
   13
   const identifier = 'user_123'
   14
   
   15
   // Generate an authorization link for the user
   16
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   17
   console.log('Authorize Mixpanel Compliance:', link)
   18
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   19
   await rl.question('Press Enter after authorizing...')
   20
   rl.close()
   21
   
   22
   // Make your first call
   23
   const result = await actions.executeTool({
   24
     connector,
   25
     identifier,
   26
     toolName: 'mixpanelcompliance_gdpr_deletion_status',
   27
     toolInput: { tracking_id: 'YOUR_TRACKING_ID', project_token: 'YOUR_PROJECT_TOKEN' },
   28
   })
   29
   console.log(result)

   npx tsx quickstart.mts

   Each user opens the link once and enters their Mixpanel credentials there. If your app already has a user's credentials, add the account from your backend instead, as the console steps above show. See Authorize a user for the full flow and statuses.