Connect HubSpot
Connects the company's HubSpot through its own private app's token.
Free
This tool costs nothing to call.
An example
Connect our HubSpot. Here is the private app's token.
Your agent callshubspot_connectFree
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"token": "pat-eu1-example-private-app-token"
}Use it when
The company keeps its customers in HubSpot and wants the agent to work in them there.
What it does
Connect the company's own HubSpot, which stays the source of truth: the agent finds, reads and changes contacts, companies, deals and tickets there. The company makes a private app in HubSpot (Settings, Integrations, Private apps) with the CRM scopes the agent may use, and gives its access token, which is checked before anything is kept. On accounts with an owner, changing an existing record waits for the owner's approval by default. Free.
What comes back
hubspot: connected_at; need_approval, the tools that now wait for the owner. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
tokenRequired | string | The private app's access token. Never shown again. 10 to 500 characters. |
The call
Over MCP, call hubspot_connect on https://api.conecto.chat/mcp/hubspot. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/hubspot_connect \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"token":"pat-eu1-example-private-app-token"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
vendor_rejected502 | HubSpot refused the token. | Copy the private app's token again. |
More HubSpot tools
All 7 tools- Search HubSpot
hubspot_searchContacts, companies, deals or tickets in HubSpot matching words.Free* - Get a HubSpot record
hubspot_getOne HubSpot record by its id, with its usual properties or the ones named.Free* - Create a HubSpot record
hubspot_createMakes a contact, company, deal or ticket in HubSpot.$0.001 a call - Change a HubSpot record
hubspot_updateChanges a HubSpot record's properties; waits for the owner by default.$0.001 a call - Add a note in HubSpot
hubspot_add_noteAdds a note to a HubSpot record's timeline, where the team sees it.$0.001 a call - Disconnect HubSpot
hubspot_disconnectForgets the private app's token; nothing in HubSpot changes.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md