Skip to main content
POST
OAuth token endpoint

Supported products

Body

application/x-www-form-urlencoded
assertion
string
client_assertion
string
client_assertion_type
string
client_id
string
client_secret
string
code
string
code_verifier
string
grant_type
enum<string>
Available options:
authorization_code,
client_credentials,
refresh_token,
urn:ietf:params:oauth:grant-type:jwt-bearer
redirect_uri
string
refresh_token
string
scope
string

Response

successful operation

access_token
string
required

A string representing the access token that allows access to the API.

expires_in
integer<int64>
required

An integer in int64 format indicating the duration in seconds until the access token expires.

refresh_token
string
required

A string representing the refresh token, which can be used to obtain a new access token.

token_type
string
required

A string indicating the type of token issued.

token_use
enum<string>
default:access_token
required

Indicates the usage of the token, which is 'access_token' by default. It is a string with a fixed value of 'access_token'.

Available options:
access_token
hub_id
integer<int32>

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

id_token
string

A string representing the ID token, which is an optional part of the response.

scopes
string[]

An array of strings specifying the scopes that are granted with the access token.

user_id
integer<int32>

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

Last modified on September 9, 2026