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

# Create an API key for the taap.it Links API

> Create a Links API key from your taap.it user settings, pick its permission level, store it safely, and know what to do if you lose it.

An API key lets another tool, or a developer you work with, create links and read statistics in taap.it without your password. You create it yourself in your user settings, and it is shown only once, so copy it right away.

> [!NOTE]
>
> API access depends on your plan. See the [pricing page](https://taap.it/pricing).

## Create a key

**1. Open your user settings**

Log in to your taap.it dashboard and go to your user settings.

**2. Create the key**

In the "API Keys" section, click "Create API Key" and give it a name you will recognize later, for example the name of the tool that will use it.

**3. Choose what it can do**

Pick a permission level. When in doubt, choose the smallest one that does the job.

**4. Copy it and store it**

The key starts with `taapit_`. Copy it and keep it somewhere safe, such as a password manager.

## Permission levels

| Level | What the key can do |
| - | - |
| Full Access | Read and change everything the API covers |
| Read Only | Read your data, change nothing. Enough for a reporting tool |
| Limited Access | Only the permissions you set, resource by resource: domains, links, projects, workspaces, analytics |

## If you lost your key

A key can't be displayed again after you create it. Create a new one, put it in the tool that used the old one, and deactivate the old key.

## Keep it secret

A key is tied to your user account and gives access to it. Never share it publicly.

> [!WARNING]
>
> If a key ends up somewhere it should not be, such as a message, a screenshot or a public web page, treat it as compromised. Create a new key and deactivate the old one.

## Radar uses different keys

The key described here is for Links. Radar has its own keys, created in the settings of each Radar project. See [Get your Radar data with the API](https://docs.taap.it/help/radar/features/api.md).

## For developers

* [Authentication](https://docs.taap.it/authentication.md): how to send the key and fix the most common errors
* [Quickstart](https://docs.taap.it/quickstart.md): from API key to first link


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