Add Note to HubSpot Contact

What the model is told

Add a note to a HubSpot contact's timeline, for example a summary of the conversation. You need the contact's record ID, so use Find HubSpot Contact first. Set the timestamp to the current date and time in UTC. Returns the new note.

Request

Headers

• Content-Typeapplication/json
• AuthorizationBearer YOUR_HUBSPOT_PRIVATE_APP_TOKEN

Body

{
  "properties": {
    "hs_timestamp": "{{timestamp}}",
    "hs_note_body": "{{noteBody}}"
  },
  "associations": [
    {
      "to": {
        "id": "{{contactId}}"
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 202
        }
      ]
    }
  ]
}

Parameters

• contactId stringThe HubSpot record ID of the contact, from Find HubSpot Contact.
• noteBody stringThe text of the note.
• timestamp stringWhen the note happened, in UTC, like 2026-03-14T09:30:00Z.

{
  "source": "VOICE_AI",
  "tool": {
    "id": "bf13cd9c-d897-4450-bc98-16874f7ff545",
    "type": "HTTP_REQUEST",
    "label": "Add Note to HubSpot Contact",
    "name": "add_note_to_hubspot_contact",
    "customName": false,
    "description": "Add a note to a HubSpot contact's timeline, for example a summary of the conversation. You need the contact's record ID, so use Find HubSpot Contact first. Set the timestamp to the current date and time in UTC. Returns the new note.",
    "parameters": [
      {
        "name": "contactId",
        "type": "string",
        "description": "The HubSpot record ID of the contact, from Find HubSpot Contact."
      },
      {
        "name": "noteBody",
        "type": "string",
        "description": "The text of the note."
      },
      {
        "name": "timestamp",
        "type": "string",
        "description": "When the note happened, in UTC, like 2026-03-14T09:30:00Z."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://api.hubapi.com/crm/v3/objects/notes"
      },
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Bearer YOUR_HUBSPOT_PRIVATE_APP_TOKEN"
        }
      ],
      "body": "{\n  \"properties\": {\n    \"hs_timestamp\": \"{{timestamp}}\",\n    \"hs_note_body\": \"{{noteBody}}\"\n  },\n  \"associations\": [\n    {\n      \"to\": {\n        \"id\": \"{{contactId}}\"\n      },\n      \"types\": [\n        {\n          \"associationCategory\": \"HUBSPOT_DEFINED\",\n          \"associationTypeId\": 202\n        }\n      ]\n    }\n  ]\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.