Skip to main content

​
Bearer token

Every API request requires your token in the Authorization header. 
Authorization: Bearer YOUR_API_TOKEN
Squid ID tokens are read-only. They can read visitor details and list your websites, and nothing else. See API tokens for how scopes work and how to revoke a token.

​
Getting a token

1

Open the API settings

In your Squid ID dashboard, go to Settings → API.
2

Create a token

Click Create token, name it, and copy it. The token is shown only once, so store it somewhere safe.

​
Example request

curl https://app.asksquid.ai/api/v1/visitors/{visitorId}/details \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "name": "Sarah Chen",
  "email": "sarah@plaid.com",
  "company": "Plaid",
  "company_role": "VP Engineering",
  "linkedin_url": "linkedin.com/in/sarachen"
}
Treat API tokens like passwords. Do not commit them to source control or expose them in client-side code. If a token leaks, revoke it in Settings → API and create a new one.