Microsoft Clarity
Server-side custom event delivery to Microsoft Clarity via the Clarity Data Export API. Complements Clarity’s session replay and heatmap features with server-side event context.
⚠️
Beta integration. Configuration and Data Export API delivery are operational. Event mappings need to be configured manually per pipeline in the current release — a pre-built preset is still being finalised. Verify that Clarity Data Export API access is available on your Clarity plan tier before configuring in production. Contact your account team for setup support.
Prerequisites
- A Microsoft Clarity project. Free tier is fine for basic analytics but Data Export API access may require a paid tier — confirm with your Clarity account representative.
- The Project ID of the Clarity project. Find it in the Clarity dashboard under Settings > Setup > Install tracking code.
- A Data Export API token. Generate under Settings > Data Export in the Clarity dashboard.
Configuration fields
| Field | Required | Notes |
|---|---|---|
project_id | Yes | Clarity project ID. |
api_token | Yes | Data Export API token (kept secret). |
Next steps
- Clarity is primarily a session-replay and heatmap tool; server-side events are used to enrich sessions with context Clarity cannot observe directly (e.g. post-transaction revenue).
- For server-side delivery of the full event stream, prefer a dedicated analytics destination like Amplitude, Mixpanel, or Matomo.