← Integrations
Live

Mixpanel + Elido: short-link clicks as Mixpanel events

Every click on a short link is tracked in Mixpanel as a link_click event with slug, country, device, destination and IP. You paste a project token and pick a data-residency region. There is no OAuth.

What you can do

What the Mixpanel integration does today

One event per click
The click-ingester sends a link_click event to Mixpanel's ingestion API for each click. A failed delivery is retried once after one second, then dropped.
US, EU and India residency
Pick us, eu or in in the dashboard. Events go to api.mixpanel.com, api-eu.mixpanel.com or api-in.mixpanel.com, which matters because a project pinned to EU or India residency drops events sent to the US host.
Test connection button
The test sends a synthetic link_click marked elido_test=true using Mixpanel's verbose mode, so malformed events are reported. Mixpanel does not verify the token or the project's region on this endpoint, so confirm the event in the Events view.
Token encrypted at rest
The project token is stored encrypted (AES-256-GCM) and shown masked. Removing the integration scrubs it.

How it works

Outbound only, off the redirect path

Edge servers publish click events to Redpanda. The click-ingester consumes them, writes to ClickHouse and, for workspaces with a Mixpanel token, sends the event to Mixpanel. Elido does not read events, profiles or reports from Mixpanel.

1
Visitor clicks

The edge serves the redirect and publishes a click event. Nothing waits on Mixpanel.

2
Click-ingester

Writes the click to ClickHouse and looks up your Mixpanel config (cached for 5 minutes).

3
Mixpanel event

link_click tracked in the project for your chosen region.

Setup guide

Connect in two steps

  1. 1
    Copy the project token

    In Mixpanel open Project settings and copy the project token. Note whether the project uses US, EU or India data residency.

  2. 2
    Paste it in Elido

    Dashboard, Integrations, Mixpanel: paste the token, choose the region, save, then press Test connection. Saving needs a workspace role with the conversions-manage permission. New settings reach the click-ingester within about 5 minutes (its config cache).

Authentication

Project token, no OAuth

Mixpanel is connected with the project token, not a service-account secret. Elido encrypts it with AES-256-GCM before storage and returns it masked. Remove the integration from the dashboard to scrub it.

The distinct_id is elido-link-<id>, so all clicks on one link are one Mixpanel user. The event has no visitor identity beyond the IP property.

Planned

Not built yet

  • Per-visitor identity: a stable distinct_id per visitor instead of per link.
  • UTM parameters and click IDs as event properties.
  • A configurable event name (it is always link_click).
  • Per-link or per-tag filtering: forwarding is per workspace, all links.

Frequently asked questions

Does Elido read my Mixpanel data?+

No. The integration only sends events. It does not read events, profiles or reports.

What does the event contain?+

The event is link_click. Properties: workspace_id, link_id, slug, country, device, destination, ip and time, plus the token and a distinct_id of elido-link-<id>.

Which region should I choose?+

The one your Mixpanel project is pinned to. A project with EU or India residency drops events sent to the US host, and the test cannot detect that.

Does it include the visitor IP?+

Yes. The ip property is sent with each event.

What if Mixpanel is down?+

Elido retries once after a second, then drops the event. There is no queue. The click remains in Elido analytics.

How do I remove it?+

Dashboard, Integrations, Mixpanel, Remove. The integration is disabled and the stored token scrubbed.

Send your link clicks to Mixpanel

Start free. No card required.