Skip to main content
GET
/
oauth
/
v1
/
access-tokens
/
{token}
Retrieve OAuth token metadata
curl --request GET \
  --url https://api.hubapi.com/oauth/v1/access-tokens/{token}
{
  "app_id": 123,
  "expires_in": 123,
  "hub_id": 123,
  "scopes": [
    "<string>"
  ],
  "token": "<string>",
  "token_type": "<string>",
  "user_id": 123,
  "hub_domain": "<string>",
  "is_private_distribution": true,
  "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
  },
  "user": "<string>"
}

Supported products

Path Parameters

​
token
string
required

Response

successful operation

​
app_id
integer<int32>
required

The ID of the application associated with the access token.

​
expires_in
integer<int32>
required

The time in seconds until the access token expires.

​
hub_id
integer<int32>
required

The ID of the HubSpot account associated with the access token.

​
scopes
string[]
required
​
token
string
required

The access token string used to make API calls.

​
token_type
string
required

The type of token, typically indicating the authentication scheme. Typically bearer.

​
user_id
integer<int32>
required

The ID of the hubspot user for whom the access token was created.

​
hub_domain
string

The domain of the HubSpot account associated with the access token.

​
is_private_distribution
boolean

Indicates whether the token is for a privately distributed application. If false, it is marketplace distributed.

​
signed_access_token
object
​
user
string

The email address of the hubspot user for whom the access token was created.

Last modified on March 31, 2026