> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Clarity - How do I link my account?

## Overview

To authenticate with Microsoft Clarity, you need:

1. **API Token** — a Data Export API token for your Clarity project.

This guide will show you how to get it.

### Prerequisites

* Admin access to the Clarity project you want to connect. Only project admins can manage API tokens, and each token belongs to one project.

### Step 1: Open your project settings

1. Sign in to [Microsoft Clarity](https://clarity.microsoft.com/) and open your project.
2. Click the **Settings** tab.

![Clarity project with the Settings tab highlighted](https://mintcdn.com/nango/tQ8AMmqRBwEAbIS-/api-integrations/microsoft-clarity/project_settings_tab.png?fit=max\&auto=format\&n=tQ8AMmqRBwEAbIS-\&q=85\&s=95eb70502f1e963a057f764178d226ff)

### Step 2: Generate an API token

1. In the Settings sidebar, select **Data export**, then click **Generate new API token**.

![Clarity Data export settings with the Generate new API token button highlighted](https://mintcdn.com/nango/tQ8AMmqRBwEAbIS-/api-integrations/microsoft-clarity/data_export_generate_token.png?fit=max\&auto=format\&n=tQ8AMmqRBwEAbIS-\&q=85\&s=6ea6e053cbae44852f3bbb5931975f53)

2. Enter a token name (4 to 32 characters: letters, digits, hyphens, underscores and periods, no spaces), then click **Add**.

![Clarity dialog for naming the new API token with the Add button](https://mintcdn.com/nango/tQ8AMmqRBwEAbIS-/api-integrations/microsoft-clarity/name_api_token.png?fit=max\&auto=format\&n=tQ8AMmqRBwEAbIS-\&q=85\&s=bccca2e3c6dcfb5e5cf025fa90a57efe)

3. Click **Copy token** to copy the generated token. It is shown only once, so store it securely.

![Clarity Token generated dialog with the Copy token button highlighted](https://mintcdn.com/nango/tQ8AMmqRBwEAbIS-/api-integrations/microsoft-clarity/copy_api_token.png?fit=max\&auto=format\&n=tQ8AMmqRBwEAbIS-\&q=85\&s=fee406b079f178902184d2e92f142798)

### Step 3: Enter your API token in the Connect UI

1. Open the form where you need to authenticate with Microsoft Clarity.
2. Enter your token in the **API Token** field.
3. Submit the form. The connection is saved without checking the token: if the token is wrong, the first API request returns an authentication error.

![Microsoft Clarity Connect UI form with the API Token field](https://mintcdn.com/nango/tQ8AMmqRBwEAbIS-/api-integrations/microsoft-clarity/form.png?fit=max\&auto=format\&n=tQ8AMmqRBwEAbIS-\&q=85\&s=ecb78b7b4a3756300512cc28e8188a69)

You are now connected to Microsoft Clarity.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.