HubSpot · JSON Structure

Hubspot Analytics Events Error Structure

Standard error response returned when an API request fails

Type: object Properties: 7 Required: 3
AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales

Error is a JSON Structure definition published by HubSpot, describing 7 properties, of which 3 are required. It conforms to the https://json-structure.org/draft/2020-12/schema meta-schema.

Properties

category correlationId message subCategory context links errors

Meta-schema: https://json-structure.org/draft/2020-12/schema

JSON Structure

Raw ↑
{
  "type": "object",
  "description": "Standard error response returned when an API request fails",
  "name": "Error",
  "properties": {
    "category": {
      "type": "string",
      "description": "High-level error category"
    },
    "correlationId": {
      "type": "uuid",
      "description": "Unique identifier for tracking and debugging the error"
    },
    "message": {
      "type": "string",
      "description": "Human-readable error message"
    },
    "subCategory": {
      "type": "string",
      "description": "Specific error subcategory for detailed classification"
    },
    "context": {
      "type": "object",
      "description": "Additional context about the error"
    },
    "links": {
      "type": "object",
      "description": "Relevant links for error resolution and documentation"
    },
    "errors": {
      "type": "array",
      "description": "List of specific errors encountered",
      "items": {
        "type": "object",
        "description": "Detailed information about a specific error",
        "properties": {
          "message": {
            "type": "string",
            "description": "Human-readable error message"
          },
          "code": {
            "type": "string",
            "description": "Machine-readable error code"
          },
          "subCategory": {
            "type": "string",
            "description": "Specific error subcategory"
          },
          "in": {
            "type": "string",
            "description": "Location where the error occurred (e.g., query, path, body)"
          },
          "context": {
            "type": "object",
            "description": "Additional context about the specific error"
          }
        },
        "required": [
          "message"
        ]
      }
    }
  },
  "required": [
    "category",
    "correlationId",
    "message"
  ],
  "$schema": "https://json-structure.org/draft/2020-12/schema"
}