conecto. Get started
HubSpot

Get a HubSpot record

hubspot_get · Reads only · Markdown

One HubSpot record by its id, with its usual properties or the ones named.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Show me the combi steamer deal for Hotel Seeblick.

Your agent callshubspot_getFree*

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"
}
What comes back
{
  "record": {
    "id": "18734511204",
    "object": "deals",
    "properties": {
      "dealname": "Combi steamers, Hotel Seeblick",
      "amount": "18400",
      "dealstage": "appointmentscheduled",
      "pipeline": "default"
    },
    "created_at": "2026-09-02T10:00:00Z",
    "updated_at": "2026-10-01T09:00:00Z"
  }
}

Use it when

A search found the record and the agent needs its details.

What it does

One contact, company, deal or ticket by its HubSpot id, with its usual properties or the ones named. Free.

What comes back

record: id, object, properties, created_at and updated_at. 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]+$.
propertiesarray of stringsThe properties to show; the usual ones when left out. Up to 50 items.

The call

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

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

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