HubSpot

Change a HubSpot record

hubspot_update · Changes data · Markdown

Changes a HubSpot record's properties; waits for the owner by default.

$0.001 a call

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

An example

Mark the Hotel Seeblick deal won at 18,400 euros.

Your agent callshubspot_update$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",
  "properties": {
    "dealstage": "closedwon",
    "amount": 18400
  }
}
What comes back
{
  "record": {
    "id": "18734511204",
    "object": "deals",
    "properties": {
      "dealstage": "closedwon",
      "amount": "18400"
    },
    "created_at": "2026-09-02T10:00:00Z",
    "updated_at": "2026-10-14T08:00:00Z"
  }
}

Use it when

A deal moves on, or a customer's details change.

What it does

Change properties of a contact, company, deal or ticket in the company's HubSpot. On accounts with an owner it waits for the owner's approval by default, showing each property's value now and after. $0.001.

What comes back

record: id, object and the properties changed. Held calls answer approval_required first. 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]+$.
propertiesRequiredobjectHubSpot property names and values, like {"dealstage": "closedwon", "amount": 18400}.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hubspot_update \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"object":"deals","id":"18734511204","properties":{"dealstage":"closedwon","amount":18400}}'

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.

Give this to your agent.

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