Skip to main content
POST
/
oauth
/
2026-03
/
token
/
introspect
Token introspection endpoint
curl --request POST \
  --url https://api.hubapi.com/oauth/2026-03/token/introspect \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'client_id=<string>' \
  --data 'client_secret=<string>' \
  --data 'token=<string>' \
  --data 'token_type_hint=<string>'
{
  "token_use": "access_token",
  "active": true,
  "token": "<string>",
  "hub_id": 123,
  "user_id": 123,
  "client_id": "<string>",
  "app_id": 123,
  "scopes": [
    "<string>"
  ],
  "signed_access_token": {
    "appId": 123,
    "expiresAt": 123,
    "hubId": 123,
    "hublet": "<string>",
    "installingUserId": 123,
    "isPrivateDistribution": true,
    "isServiceAccount": true,
    "isUserLevel": true,
    "newSignature": "<string>",
    "scopeToScopeGroupPks": "<string>",
    "scopes": "<string>",
    "signature": "<string>",
    "trialScopeToScopeGroupPks": "<string>",
    "trialScopes": "<string>",
    "userId": 123
  },
  "expires_in": 123,
  "is_private_distribution": true,
  "token_type": "<string>",
  "user": "<string>",
  "hub_domain": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Body

application/x-www-form-urlencoded
client_id
string
client_secret
string
token
string
token_type_hint
string

Response

successful operation

token_use
enum<string>
default:access_token
required
Available options:
access_token
active
boolean
required
token
string
required
hub_id
integer<int32>
required
user_id
integer<int32>
required
client_id
string
required
app_id
integer<int32>
required
scopes
string[]
required
signed_access_token
object
required
expires_in
integer<int64>
required
is_private_distribution
boolean
required
token_type
string
required
user
string
hub_domain
string
Last modified on May 11, 2026