Refresh an access token

curl --request POST \
  --url https://api.hubapi.com/oauth/v1/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data grant_type=authorization_code \
  --data 'code=<string>' \
  --data 'redirect_uri=<string>' \
  --data 'client_id=<string>' \
  --data 'client_secret=<string>' \
  --data 'refresh_token=<string>'

{
  "access_token": "<string>",
  "refresh_token": "<string>",
  "id_token": "<string>",
  "token_type": "<string>",
  "expires_in": 123
}

Tokens

Refresh an access token

Use a previously obtained refresh token to generate a new access token.

Access tokens are short lived. You can check the expires_in parameter when generating an access token to determine its lifetime (in seconds). If you need offline access to HubSpot data, store the refresh token you get when initiating your OAuth integration and use it to generate a new access token once the initial one expires.

Note: HubSpot access tokens will fluctuate in size as the information that’s encoded in them changes over time. It’s recommended to allow for tokens to be up to 300 characters to account for any potential changes.

POST

oauth

token

Refresh an access token

curl --request POST \
  --url https://api.hubapi.com/oauth/v1/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data grant_type=authorization_code \
  --data 'code=<string>' \
  --data 'redirect_uri=<string>' \
  --data 'client_id=<string>' \
  --data 'client_secret=<string>' \
  --data 'refresh_token=<string>'

{
  "access_token": "<string>",
  "refresh_token": "<string>",
  "id_token": "<string>",
  "token_type": "<string>",
  "expires_in": 123
}

Supported products

Requires one of the following products or higher.

Marketing HubFree

Sales HubFree

Service HubFree

Content HubFree

Body

application/x-www-form-urlencoded

Response

200

application/json

successful operation

The response is of type object.

Manage OAuth access tokens

Retrieve OAuth token metadata