HubSpot · JSON Structure

Oauth Api Token Response Structure

Response containing the new access token and related information

Type: object Properties: 5 Required: 4
AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales

TokenResponse is a JSON Structure definition published by HubSpot, describing 5 properties, of which 4 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

access_token token_type expires_in refresh_token id_token

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/oauth-api-token-response-structure.json",
  "name": "TokenResponse",
  "description": "Response containing the new access token and related information",
  "type": "object",
  "properties": {
    "access_token": {
      "type": "string",
      "description": "The new access token",
      "example": "CKDZpunPLhICAQEYs-gDIIGOBii1hQIyGQAf3xBKEgsYjYMJVvlHEz9tFHAwSq1TQAM40s0D"
    },
    "token_type": {
      "type": "string",
      "description": "The type of token (always 'bearer')",
      "example": "bearer"
    },
    "expires_in": {
      "type": "int32",
      "description": "Number of seconds until the access token expires",
      "example": 1800
    },
    "refresh_token": {
      "type": "string",
      "description": "The refresh token for obtaining new access tokens",
      "example": "6f18f26a-3e95-4d95-a6e5-3d5c6e5c9e5a"
    },
    "id_token": {
      "type": "string",
      "description": "The ID token (only returned if openid scope was requested)",
      "example": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
    }
  },
  "required": [
    "access_token",
    "token_type",
    "expires_in",
    "refresh_token"
  ]
}