conecto. Get started
HubSpot

Search HubSpot

hubspot_search · Reads only · Markdown

Contacts, companies, deals or tickets in HubSpot matching words.

Free*

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

An example

What deals do we have with Hotel Seeblick?

Your agent callshubspot_searchFree*

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",
  "query": "Hotel Seeblick"
}
What comes back
{
  "object": "deals",
  "total": 1,
  "records": [
    {
      "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

The agent needs a customer, a company or a deal before it answers or acts.

What it does

Contacts, companies, deals or tickets in the company's HubSpot matching words (a name, an email, a deal's name), with their usual properties or the ones named. Free.

What comes back

object, total, and records: each with 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.
querystringUp to 200 characters.
propertiesarray of stringsThe properties to show; the usual ones when left out. Up to 50 items.
limitinteger1 to 100. Default: 20.

The call

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

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

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.

More HubSpot tools

All 7 tools

Give this to your agent.

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