Advanced

Token introspection endpoint

Changed on

Returns validity and metadata for access and refresh tokens.

post/oauth/2026-03/token/introspect

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/oauth/2026-03/token/introspect
  • Auth
    none declared

Request body application/x-www-form-urlencoded

client_idstring
client_secretstring
tokenstring
token_type_hintstring

Response

successful operation

OR

Changes

  • 2026-0303dfd4737244Revision changes
    • breaking

      added to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • warning

      removed the optional property from the response with the status

    • info

      removed response discriminator for the response status

  • 2026-0333cdb28eb03dRevision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      added response discriminator for the response status

    • info

      removed from the response body oneOf list for the response status

    • info

      added the optional property to the response with the status