Skip to main content
API tokens give read-only programmatic access to your identified visitors and your website list. Tokens are managed under Settings → API in the dashboard. For the endpoints and request shapes, see the API reference.

​
Before you start

API access is a paid add-on. Enable it under Settings → Add-ons 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.
Keys are read-only and scoped to one website. They work on the visitor details endpoint only. The base URL is https://id-api.asksquid.ai/api, and you send the key as Authorization: Bearer <key>.

​
Create a token

Only an Owner can manage API tokens.
1

Open the API page

Go to Settings → API and click New token.
2

Name it

Give the token a short label, up to 20 characters, so you can tell tokens apart later (for example, “Production” or “Zapier”).
3

Copy it once

Click Create token. The full token is shown one time only.
Copy the token immediately. For security it is never shown again. If you lose it, revoke it and create a new one.

​
Revoke a token

On the API page, click Revoke 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.