Managing tokens

Get OAuth 2.0 access and refresh tokens:

Use the code you get after a user authorizes your app to get an access token and refresh token. The access token will be used to authenticate requests that your app makes. Access tokens expire after six hours, so you can use the refresh token endpoint to get a new access token when the first access token expires.

Use a previously obtained refresh token to generate a new access token. Access tokens expire after six hours. 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 we change the information that is encoded. We recommend allowing for tokens to be up to 300 characters to account for any changes.

 

Get Information for OAuth 2.0 access or refresh token:

Get the meta data for an access or refresh token. This can be used to get the email address of the HubSpot user that the token was created for, as well as the Hub ID that the token is associated with.

 

Delete OAuth 2.0 Refresh Token:

Deletes a refresh token. You can use this to delete your refresh token if a user uninstalls your app.

Note: This will only delete the refresh token. Access tokens generated with the refresh token will not be affected. Additionally, this will not uninstall an application from a HubSpot account or inhibit data syncing between an account and a connected application.

 

Using OAuth 2.0 access tokens:

// Authorization: Bearer {token}

curl --request GET \

  --url 'https://api.hubapi.com/crm/v3/objects/contacts?limit=10&archived=false' \

  --header 'authorization: Bearer CJSP5qf1KhICAQEYs-gDIIGOBii1hQIyGQAf3xBKmlwHjX7OIpuIFEavB2-qYAGQsF4'

{contacts: .....}

 

  In this example, the access token is:

 CJSP5qf1KhICAQEYs-gDIIGOBii1hQIyGQAf3xBKmlwHjX7OIpuIFEavB2-qYAGQsF4

Notes: If you're using OAuth 2.0 access tokens, you should not include hapikey= in the request URL. The Authorization header is used in place of that query parameter.