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

# API tokens

> Generate read-only Bearer tokens for the Squid ID API, scope programmatic access to identified visitors, and revoke a token when you no longer need it.

API tokens give read-only programmatic access to your identified visitors and your website list. Tokens are managed under <strong>Settings → API</strong> in the dashboard. For the endpoints and request shapes, see the [API reference](/api-reference/overview).

## Before you start

API access is a paid add-on. Enable it under <strong>Settings → Add-ons</strong> first; until you do, the API page prompts you to enable it. Most teams use the Slack, HubSpot, Clay, and Webhook connectors, which are included free, instead.

<Info>Keys are <strong>read-only</strong> and scoped to one website. They work on the visitor details endpoint only. The base URL is <code>[https://id-api.asksquid.ai/api](https://id-api.asksquid.ai/api)</code>, and you send the key as <code>Authorization: Bearer \<key></code>.</Info>

## Create a token

Only an Owner can manage API tokens.

<Steps>
  <Step title="Open the API page">
    Go to <strong>Settings → API</strong> and click <strong>New token</strong>.
  </Step>

  <Step title="Name it">
    Give the token a short label, up to 20 characters, so you can tell tokens apart later (for example, "Production" or "Zapier").
  </Step>

  <Step title="Copy it once">
    Click <strong>Create token</strong>. The full token is shown one time only.
  </Step>
</Steps>

<Warning>Copy the token immediately. For security it is never shown again. If you lose it, revoke it and create a new one.</Warning>

## Revoke a token

On the API page, click <strong>Revoke</strong> on any token and confirm. Any integration using that token stops working immediately. This cannot be undone.

## Full API reference

This page covers token management. For the endpoints, parameters, and response shapes, see the [API reference](/api-reference/overview).