Advanced

Token introspection endpoint

Changed on May 27, 2026

Returns validity and metadata for access and refresh tokens.

post/oauth/2026-03/token/introspect

Request

Base URL
https://api.hubapi.com
Auth
- HTTP bearer
- or API key in query parameter hapikey
- or none
TypeScript
https://skmtc.dev/hubspot/apis/hubspot-api-specification/docs/oauth/2026-03/token/introspect/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body application/x-www-form-urlencoded

client_idstring

client_secretstring

tokenstring

token_type_hintstring

Response

successful operation

Changes

May 27, 2026f9c7181056c5 Revision changes
- breaking
  the /// response's property type changed from no type to object for status
- breaking
  the /// response's property type changed from no type to object for status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  removed subschema #1 from the /// response property allOf list for the response status
- info
  removed subschema #1 from the /// response property allOf list for the response status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
Apr 8, 2026b0d8bc008db9 Revision changes
- info
  api operation id post-/oauth/2026-03/token/introspect_/oauth/v3/token/introspect removed and replaced with post-/oauth/2026-03/token/introspect

Some revisions have not been checked yet.

Operation history (4 revisions)

Token introspection endpoint

Request

Request body application/x-www-form-urlencoded

Response 200OK

Changes

Response