HubSpot

Create a HubSpot record

hubspot_create · Changes data · Markdown

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.

With these arguments
{
  "object": "contacts",
  "properties": {
    "email": "einkauf@hotel-seeblick.example",
    "firstname": "Petra",
    "lastname": "Lindqvist",
    "company": "Hotel Seeblick"
  }
}
What comes back
{
  "record": {
    "id": "6001",
    "object": "contacts",
    "properties": {
      "email": "einkauf@hotel-seeblick.example",
      "firstname": "Petra",
      "lastname": "Lindqvist",
      "company": "Hotel Seeblick"
    },
    "created_at": "2026-10-14T08:00:00Z",
    "updated_at": "2026-10-14T08:00:00Z"
  }
}

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

NameTypeWhat it is
objectRequiredstringcontacts, companies, deals or tickets. One of: contacts,companies,deals,tickets.
propertiesRequiredobjectHubSpot 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:

Terminal
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.

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.
conflict409HubSpot has a contact with that email already.Search for it and change it.

Give this to your agent.

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