HubSpot · Schema

Error

Standard error response returned when an API request fails

AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales

Properties

Name Type Description
category string High-level error category
correlationId string Unique identifier for tracking and debugging
message string Human-readable error message
subCategory string Specific error subcategory
context object Additional error context
links object Related links for error resolution
errors array List of specific errors
View JSON Schema on GitHub

JSON Schema

hubspot-authors-error-schema.json Raw ↑
{
  "type": "object",
  "description": "Standard error response returned when an API request fails",
  "properties": {
    "category": {
      "type": "string",
      "description": "High-level error category",
      "example": "standard"
    },
    "correlationId": {
      "type": "string",
      "description": "Unique identifier for tracking and debugging",
      "format": "uuid",
      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "message": {
      "type": "string",
      "description": "Human-readable error message",
      "example": "This is an example description."
    },
    "subCategory": {
      "type": "string",
      "description": "Specific error subcategory",
      "example": "standard"
    },
    "context": {
      "type": "object",
      "description": "Additional error context",
      "example": {
        "key": "value"
      }
    },
    "links": {
      "type": "object",
      "description": "Related links for error resolution",
      "example": {
        "key": "value"
      }
    },
    "errors": {
      "type": "array",
      "description": "List of specific errors",
      "example": [
        {
          "message": "This is an example description.",
          "code": "example-value",
          "subCategory": "standard",
          "in": "example-value",
          "context": {
            "key": "value"
          }
        }
      ],
      "items": {
        "type": "object",
        "description": "Detailed information about a specific error",
        "properties": {
          "message": {
            "type": "string",
            "description": "Human-readable error message",
            "example": "This is an example description."
          },
          "code": {
            "type": "string",
            "description": "Machine-readable error code",
            "example": "example-value"
          },
          "subCategory": {
            "type": "string",
            "description": "Specific error subcategory",
            "example": "standard"
          },
          "in": {
            "type": "string",
            "description": "Location where the error occurred",
            "example": "example-value"
          },
          "context": {
            "type": "object",
            "description": "Additional context about the error",
            "example": {
              "key": "value"
            }
          }
        },
        "required": [
          "message"
        ]
      }
    }
  },
  "required": [
    "category",
    "correlationId",
    "message"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Error"
}