There's a new version of the HubSpot API

Check out the new API
View Beta Docs

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Get Information for OAuth 2.0 Access Token

Last updated June 17, 2020

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

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

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.

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example GET URL: https://api.hubapi.com/oauth/v1/access-tokens/CJSP5qf1KhICAQEYs-gDIIGOBii1hQIyGQAf3xBKmlwHjX7OIpuIFEavB2-qYAGQsF4 Example Response: { "token": "CJSP5qf1KhICAQEYs-gDIIGOBii1hQIyGQAf3xBKmlwHjX7OIpuIFEavB2-qYAGQsF4", "user": "test@hubspot.com", "hub_domain": "demo.hubapi.com", "scopes": [ "contacts", "automation", "oauth" ], "hub_id": 62515, "app_id": 456, "expires_in": 21588, "user_id": 123, "token_type": "access" }