HubSpot · Schema

Contact

A HubSpot contact record.

AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales

Properties

Name Type Description
id string The unique identifier for the contact.
properties object The contact's properties as key-value pairs.
createdAt string The date and time the contact was created.
updatedAt string The date and time the contact was last updated.
archived boolean Whether the contact has been archived.
associations object The contact's associations with other CRM objects.
View JSON Schema on GitHub

JSON Schema

crm-contacts-api-contact-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/crm-contacts-api-contact-schema.json",
  "title": "Contact",
  "description": "A HubSpot contact record.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier for the contact.",
      "example": "500123"
    },
    "properties": {
      "type": "object",
      "description": "The contact's properties as key-value pairs.",
      "additionalProperties": {
        "type": "string"
      },
      "example": {
        "key": "value"
      }
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time the contact was created.",
      "example": "2025-03-15T14:30:00Z"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time the contact was last updated.",
      "example": "2025-03-15T14:30:00Z"
    },
    "archived": {
      "type": "boolean",
      "description": "Whether the contact has been archived.",
      "example": true
    },
    "associations": {
      "type": "object",
      "description": "The contact's associations with other CRM objects.",
      "additionalProperties": {
        "type": "object",
        "description": "A list of associations.",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Association"
            },
            "example": [
              {
                "id": "500123",
                "type": "standard"
              }
            ]
          },
          "paging": {
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "example": {
        "key": "value"
      }
    }
  }
}