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 Refresh Token

Last updated June 17, 2020

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

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Get the meta data for a 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.
Required Parameters How to use Description
Refresh Token  :token
Used in the request URL
 The refresh token that you want to get the information for.

Optional Parameters How to use Description
None None No optional parameters for this method.
Note: For a more elaborate walkthrough on initiating Oauth, visit this link.