There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

Get Information for OAuth 2.0 Access Token

Last updated June 17, 2020

GET /oauth/v1/access-tokens/:token

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Get the meta data for an access 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.
Note: HubSpot access tokens will fluctuate in size as we change the information that is encoded the tokens. We recommend allowing for tokens to be up to 300 characters to account for any changes we may make.
Required Parameters How to use Description
Access Token  :token
Used in the request URL
 The access token that you want to get the information for.

Optional ParametersHow to useDescription
None None No optional parameters for this method.