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

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Path Parameters

token
string
required

The access token that you want to retrieve information about.

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 December 16, 2025