Lucien treats product analytics as first-class company context. When Mixpanel is connected, Lucien can reason over your events, volumes, and (optionally) saved funnels—so briefs and answers reflect what users are actually doing, not guesses.

This page covers:

• What you need in Mixpanel before connecting
• How to connect from the Lucien dashboard
• Optional saved funnel setup for conversion metrics
• Mixpanel plan requirements
• What Lucien can do once Mixpanel is wired up
• Troubleshooting common issues

---

1. Before you connect

You will need admin or project-level access to the Mixpanel project you want Lucien to use.

Lucien authenticates with Mixpanel using a Consumer Service Account (username + secret), not your personal login. Create that account inside Mixpanel so you can rotate or revoke access without sharing passwords.

Mixpanel plan

Lucien uses:

• Mixpanel’s export capabilities to ingest recent event data and build an internal picture of your event catalogue.
• Mixpanel’s segmentation / Query API for metrics such as daily active users and related snapshots.
• The funnels Query API when you provide a saved funnel id (optional).

On free or heavily limited Mixpanel plans, some of these API calls may be refused (for example HTTP 402). If metrics or funnel summaries fail to load, confirm your project is on a paid Mixpanel plan that includes the relevant API access. See Mixpanel’s own billing and API documentation for current limits.

Data region (US vs EU)

If your Mixpanel project uses EU data residency, choose EU when connecting in Lucien. If you pick the wrong region, validation and sync will fail—switch to the matching region and connect again.

---

2. Create a Mixpanel service account

1. In Mixpanel, open Project Settings (gear) for the project Lucien should see.
2. Go to Service Accounts (wording may vary slightly in the Mixpanel UI).
3. Create a Consumer service account (or equivalent) with access to this project.
4. Copy the username and secret when Mixpanel shows them. You may only see the secret once—store it safely until you paste it into Lucien.

Grant the minimum access your security policy allows while still allowing project data read (export and query) for that project. Exact permission names are defined by Mixpanel; if unsure, use Mixpanel’s documentation for service accounts.

---

3. Connect Mixpanel in Lucien

1. Open Integrations in the Lucien dashboard.
2. Find Mixpanel (under analytics integrations) and start the connect flow.
3. Enter:
   • Service Account Username (required)
   • Service Account Secret (required)
   • Data Region: US (default) or EU if your project is EU-hosted
4. Optionally enter a Saved funnel ID (see below).
5. Click Connect.

If the credentials and region are correct, the integration should show as connected. Lucien will encrypt these credentials at rest; they are not stored in plain text.

---

4. Saved funnel ID (optional)

Some Lucien features use Mixpanel’s funnel Query API for conversion and time-to-value style metrics. That requires a saved funnel in Mixpanel and its funnel id.

If you skip this field, Lucien can still sync events and many metrics; funnel-specific summaries may be unavailable until you add an id.

To configure it:

1. In Mixpanel, create or open the funnel you care about (for example signup → activation → paid).
2. Save the funnel in the Mixpanel UI if it is not already saved.
3. Obtain the funnel id Mixpanel associates with that saved funnel (often visible in the Mixpanel URL or funnel details—exact location depends on Mixpanel’s current UI).
4. Paste that id into Saved funnel ID in Lucien’s Mixpanel connect form (or add it when reconnecting).

If you change funnels later, update the id in Lucien’s integration settings or reconnect with the new value.

---

5. What happens after you connect

After a successful connection, Lucien:

• Validates access to your Mixpanel project and records the project identity when needed.
• Runs a cold backfill over recent history so the event catalogue and downstream metrics are populated.
• Continues with scheduled incremental sync so new data is picked up over time.
• May compute metric snapshots (for example usage-style metrics) on a schedule, depending on your org’s configuration.

You do not need to manually export CSVs; Lucien pulls from Mixpanel’s APIs within the limits of your plan and Lucien’s sync jobs.

---

6. What Lucien can do with Mixpanel connected

With Mixpanel connected, Lucien can use your product analytics alongside billing, docs, and other integrations. For example:

• Explain changes in usage — “How did last week’s active users compare to the prior week?”
• Ground answers in real events — questions about specific funnels, steps, or event names that exist in your project (names must match what you track in Mixpanel).
• Support briefs and alerts — product signals can validate or challenge assumptions in revenue, support, or marketing context.

Lucien reads from Mixpanel to analyze and summarize. It does not use this integration to rewrite your Mixpanel project settings, delete data, or send arbitrary events into Mixpanel on your behalf.

---

7. Troubleshooting

“Connection failed” or validation errors

• Double-check username and secret (no extra spaces; secret not expired or rotated).
• Confirm US vs EU matches where the project’s data lives.
• Ensure the service account still has access to the correct project.

Metrics or funnel calls fail; errors mention billing or 402

• Your Mixpanel plan may not include Query API / segmentation (or funnel) access. Upgrade or adjust the plan per Mixpanel, then try again.

Funnel features say there is no saved funnel id

• Add a Saved funnel ID in the Mixpanel integration in Lucien (see section 4), or reconnect with that field filled in.

Integration shows an error after it used to work

• The secret may have been rotated or revoked in Mixpanel, or the service account lost project access. Create a new secret or account in Mixpanel and reconnect in Lucien.

Numbers in Lucien and Mixpanel look slightly different

• Lucien uses API responses and sync windows that may not match an arbitrary date range you picked in the Mixpanel UI. Align the date range and definitions (event names, funnel version) when comparing.

If something still looks wrong, email team@lucienai.io with a short description and (if possible) a screenshot of the integration state in Lucien.

---

8. Disconnecting or rotating credentials

To stop Lucien from accessing Mixpanel, disconnect the integration from Integrations and revoke or delete the service account in Mixpanel if you no longer need it.

To rotate credentials safely: create a new service account secret (or a new account) in Mixpanel, then reconnect in Lucien so only the new credentials are stored.