conecto. Get started
HubSpot

Add a note in HubSpot

hubspot_add_note · Changes data · Markdown

Adds a note to a HubSpot record's timeline, where the team sees it.

$0.001 a call

From your agent’s balance. A call that fails costs nothing.

An example

Note on the deal that Petra confirmed delivery for the week of November 9.

Your agent callshubspot_add_note$0.001 a call

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "object": "deals",
  "id": "18734511204",
  "body": "Petra confirmed delivery of the two combi steamers for the week of November 9."
}
What comes back
{
  "note": {
    "note_id": "9001",
    "on": {
      "object": "deals",
      "id": "18734511204"
    }
  }
}

Use it when

Something the customer said or agreed should be on the record.

What it does

A note on a contact, company, deal or ticket's timeline in HubSpot, where the team sees it: what a customer said on the phone, what was agreed. $0.001.

What comes back

note: note_id, and the record it is on. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
objectRequiredstringcontacts, companies, deals or tickets. One of: contacts,companies,deals,tickets.
idRequiredstringThe record's HubSpot id. 1 to 40 characters, matches ^[0-9]+$.
bodyRequiredstring1 to 10,000 characters.

The call

Over MCP, call hubspot_add_note on https://api.conecto.chat/mcp/hubspot. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hubspot_add_note \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"object":"deals","id":"18734511204","body":"Petra confirmed delivery of the two combi steamers for the week of November 9."}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_connected409HubSpot isn't connected yet.Connect it with hubspot_connect.
vendor_rejected502HubSpot refused: the token is wrong, or the private app lacks the scope.Add the scope the message names to the private app.
not_found404HubSpot has no record with that id.Search first and use its id.

More HubSpot tools

All 7 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md