Create a HubSpot record
Makes a contact, company, deal or ticket in HubSpot.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Add Petra Lindqvist from Hotel Seeblick to HubSpot.
Your agent callshubspot_create$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.
{
"object": "contacts",
"properties": {
"email": "einkauf@hotel-seeblick.example",
"firstname": "Petra",
"lastname": "Lindqvist",
"company": "Hotel Seeblick"
}
}Use it when
A new customer or deal comes up and the sales team works in HubSpot.
What it does
Make a contact, company, deal or ticket in the company's HubSpot with the properties given. HubSpot refuses a second contact with the same email. $0.001.
What comes back
record: the new record's id, object and the properties given. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
objectRequired | string | contacts, companies, deals or tickets. One of: contacts,companies,deals,tickets. |
propertiesRequired | object | HubSpot property names and values, like {"dealstage": "closedwon", "amount": 18400}. |
The call
Over MCP, call hubspot_create on https://api.conecto.chat/mcp/hubspot. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/hubspot_create \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"object":"contacts","properties":{"email":"einkauf@hotel-seeblick.example","firstname":"Petra","lastname":"Lindqvist","company":"Hotel Seeblick"}}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_connected409 | HubSpot isn't connected yet. | Connect it with hubspot_connect. |
vendor_rejected502 | HubSpot refused: the token is wrong, or the private app lacks the scope. | Add the scope the message names to the private app. |
conflict409 | HubSpot has a contact with that email already. | Search for it and change it. |
More HubSpot tools
All 7 tools- Connect HubSpot
hubspot_connectConnects the company's HubSpot through its own private app's token.Free - 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* - 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