Connect AI agents to Mixpanel Compliance

1. Install the SDK

   Section titled “Install the SDK”
   • Node.js
   • Python

   1
   npm install @scalekit-sdk/node dotenv

   Full SDK reference: Node.js | Python

2. Set your credentials

   Section titled “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. Set up the connector

   Section titled “Set up the connector”

   Register your Mixpanel Compliance credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.

   Dashboard setup steps

   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 — there is no redirect URI or OAuth flow.

   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 them via the dashboard for testing, or via the Scalekit API in production.

      Via dashboard (for testing)

      • 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.

      Via API (for production)

      • Node.js
      • Python

      1
      // US region (default) — omit `domain` or set it to 'mixpanel.com/api'
      2
      await scalekit.connect.upsertConnectedAccount({
      3
        connectionName: 'mixpanelcompliance',
      4
        identifier: 'user@example.com',
      5
        credentials: {
      6
          token: 'your-gdpr-compliance-token',
      7
          domain: 'mixpanel.com/api',
      8
        },
      9
      })
      10
      
      11
      // EU region
      12
      await scalekit.connect.upsertConnectedAccount({
      13
        connectionName: 'mixpanelcompliance',
      14
        identifier: 'eu-user@example.com',
      15
        credentials: {
      16
          token: 'your-eu-gdpr-compliance-token',
      17
          domain: 'eu.mixpanel.com/api',
      18
        },
      19
      })

4. Make your first call

   Section titled “Make your first call”
   • Node.js
   • Python

   1
   import { ScalekitClient } from '@scalekit-sdk/node'
   2
   import 'dotenv/config'
   3
   
   4
   const scalekit = new ScalekitClient(
   5
     process.env.SCALEKIT_ENVIRONMENT_URL,
   6
     process.env.SCALEKIT_CLIENT_ID,
   7
     process.env.SCALEKIT_CLIENT_SECRET,
   8
   )
   9
   const actions = scalekit.actions
   10
   
   11
   const connector = 'mixpanelcompliance'
   12
   const identifier = 'user_123'
   13
   
   14
   // Make your first call
   15
   const result = await actions.executeTool({
   16
     connector,
   17
     identifier,
   18
     toolName: 'mixpanelcompliance_gdpr_deletion_status',
   19
     toolInput: { tracking_id: 'YOUR_TRACKING_ID', project_token: 'YOUR_PROJECT_TOKEN' },
   20
   })
   21
   console.log(result)

   1
   npx tsx quickstart.mts

Connect this agent connector to let your agent:

• Status gdpr retrieval, gdpr deletion — Check the status of a GDPR/CCPA data retrieval (Subject Access Request) previously created with ‘mixpanelcompliance_gdpr_retrieval_create’
• Create gdpr retrieval, gdpr deletion — Create a GDPR or CCPA Subject Access Request (SAR) for one or more Mixpanel distinct_ids
• Cancel gdpr deletion — Cancel a pending GDPR/CCPA data deletion request before Mixpanel begins permanently erasing the data

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.