Skip to main content
POST
Token introspection endpoint

Supported products

Body

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

Response

successful operation

active
boolean
required

A boolean indicating whether the token is currently active.

app_id
integer<int32>
required

An integer representing the unique identifier of the application associated with the token.

client_id
string
required

A string representing the client ID associated with the token.

expires_in
integer<int64>
required

An integer in int64 format representing the time in seconds until the token expires.

hub_id
integer<int32>
required

An integer representing the unique identifier of the HubSpot account (hub) associated with the token.

is_private_distribution
boolean
required

A boolean indicating whether the token is for private distribution.

scopes
string[]
required

An array of strings representing the scopes (permissions) granted to the token.

signed_access_token
object
required
token
string
required

A string representing the token itself.

token_type
string
required

A string representing the type of the token.

token_use
enum<string>
default:access_token
required

A string indicating the use of the token, which defaults to 'access_token'.

Available options:
access_token
user_id
integer<int32>
required

An integer representing the unique identifier of the user associated with the token.

hub_domain
string

A string representing the domain of the HubSpot account associated with the token.

user
string

A string representing the username associated with the token.

Last modified on September 9, 2026