Linking Microsoft Clarity as a source

Alpha release

This source is currently in alpha. The interface and available tables may change.

Let AI connect your sources for you

Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

Learn more

The Microsoft Clarity connector syncs engagement and frustration-signal metrics into PostHog's data warehouse. It pulls data from the Clarity Data Export API using a project-level API token.

Adding a data source

Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to Microsoft Clarity.
In your Microsoft Clarity project, go to Settings → Data Export → Generate new API token and copy the token.
Back in PostHog, paste the token into the API token field.
Choose a Reporting window — last 24, 48, or 72 hours — to control how much trailing data each sync pulls.
Optionally select up to three Breakdown dimensions (e.g. Browser, Device, Country/Region, OS, Source, Medium, Campaign, Channel, URL) to split metrics by.
Select the tables you want to sync, set the sync frequency, then click Import.

Once the sync completes, you can query your Clarity data in PostHog.

Available tables

Table	Description	Sync method
`project_live_insights`	Engagement and frustration-signal metrics (traffic, scroll depth, engagement time, popular pages, dead/rage/quickback/error clicks, script errors) aggregated over the reporting window, optionally broken down by dimensions	Append only

Append only means each sync adds a new set of snapshot rows (stamped with synced_at) rather than updating existing records. This is because the Clarity API only returns a rolling window of the last 1–3 days with no historical cursor — recurring syncs accumulate history over time.

Sync limitations

No historical backfill. The Clarity Data Export API only returns the last 1–3 days of aggregated data. There is no way to pull older history.
10 requests per project per day. Microsoft Clarity enforces a daily quota of 10 API requests per project. Each PostHog sync uses one request, so schedule syncs accordingly. Credential validation at setup also counts against this quota.
Snapshot-based accumulation. Because the API has no incremental cursor, each sync appends a fresh snapshot. Use the synced_at column to distinguish between syncs when querying.

Troubleshooting

401 – Invalid or expired API token: Generate a new token in Microsoft Clarity under Settings → Data Export and reconnect the source in PostHog.

403 – Token not authorized: The API token doesn't have access to this Clarity project. Verify you generated the token from the correct project.

429 – Daily quota exhausted: The project's 10-request daily quota has been used up (possibly by other integrations or manual API calls). The quota resets daily — try again after it resets.

Configuration

Option	Type	Required
`API token`	password	Yes
`Reporting window`	select	Yes
`Breakdown dimension 1 (optional)`	select	No
`Breakdown dimension 2 (optional)`	select	No
`Breakdown dimension 3 (optional)`	select	No

Supported tables

Table	Description	Sync method	Incremental field	Primary key
`project_live_insights`	Engagement and frustration-signal metrics (traffic, scroll depth, engagement time, popular pages, dead/rage/quickback/error clicks, script errors) from the Microsoft Clarity Data Export API, aggregated over the requested reporting window and optionally broken down by up to three dimensions. Each sync appends a new snapshot rather than replacing prior data, since the API only ever returns the last 1-3 days.	Append only, Full refresh	Synced at	—