HubSpot · JSON Structure

Engagement Notes Note Structure

Represents a note engagement in the CRM

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

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

Properties

id properties propertiesWithHistory createdAt updatedAt archived archivedAt

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/engagement-notes-note-structure.json",
  "name": "Note",
  "description": "Represents a note engagement in the CRM",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier for the note",
      "example": "1024"
    },
    "properties": {
      "type": "object",
      "description": "The note properties",
      "additionalProperties": {
        "type": "string"
      },
      "example": {
        "hs_note_body": "Met with client to discuss Q1 goals. They are interested in expanding their subscription.",
        "hs_timestamp": "2024-01-15T10:30:00.000Z",
        "hubspot_owner_id": "12345"
      }
    },
    "propertiesWithHistory": {
      "type": "object",
      "description": "Properties with their change history",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "description": "Historical value of a property",
          "properties": {
            "value": {
              "type": "string",
              "description": "The historical value",
              "example": "Initial meeting notes"
            },
            "timestamp": {
              "type": "datetime",
              "description": "When the value was set",
              "example": "2024-01-15T10:30:00.000Z"
            },
            "sourceType": {
              "type": "string",
              "description": "The source type that set this value",
              "example": "CRM_UI"
            },
            "sourceId": {
              "type": "string",
              "description": "The source identifier",
              "example": "userId:12345"
            },
            "sourceLabel": {
              "type": "string",
              "description": "Human-readable source label",
              "example": "John Doe"
            },
            "updatedByUserId": {
              "type": "int32",
              "description": "The user ID who made the change",
              "example": 12345
            }
          }
        }
      },
      "example": {
        "key": "value"
      }
    },
    "createdAt": {
      "type": "datetime",
      "description": "When the note was created",
      "example": "2024-01-15T10:30:00.000Z"
    },
    "updatedAt": {
      "type": "datetime",
      "description": "When the note was last updated",
      "example": "2024-01-15T11:00:00.000Z"
    },
    "archived": {
      "type": "boolean",
      "description": "Whether the note is archived",
      "example": false
    },
    "archivedAt": {
      "type": "datetime",
      "description": "When the note was archived (if archived)",
      "example": "2025-03-15T14:30:00Z"
    }
  },
  "required": [
    "id",
    "properties",
    "createdAt",
    "updatedAt",
    "archived"
  ]
}