HubSpot
Connects to the HubSpot CRM API for managing contacts, deals, and notes. An agent can list, search, and create contacts, list and create deals, and log notes.
Add to an agent node's tools array with _node_type: "tool-hubspot". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
access_token | Yes | HubSpot Private App access token, sent as Authorization: Bearer <token>. Typically a stored secret. |
{
"name": "hubspot",
"_node_type": "tool-hubspot",
"access_token": "{{ secret.HUBSPOT_ACCESS_TOKEN }}"
}
Tools
hubspot_list_contacts
List contacts from HubSpot CRM.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max contacts to return (default 20) |
Returns: A list of - **<first> <last>** <<email>> @ <company> id: <id> lines, or "No contacts found.".
hubspot_get_contact
Get full details of a HubSpot contact.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
contact_id | string | Yes | HubSpot contact ID |
Returns: A heading with the contact ID followed by its properties (firstname, lastname, email, phone, company, website, city, state, country, jobtitle, lifecyclestage) as pretty-printed JSON.
hubspot_create_contact
Create a new contact in HubSpot CRM.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Contact email address |
first_name | string | No | First name |
last_name | string | No | Last name |
phone | string | No | Phone number |
company | string | No | Company name |
job_title | string | No | Job title |
Returns: "Contact created. ID: <id>".
hubspot_search_contacts
Search for HubSpot contacts by name, email, or company.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query (searches name, email, company) |
Returns: A list of - **<first> <last>** <<email>> id: <id> lines (up to 20), or "No contacts found.".
hubspot_list_deals
List deals from HubSpot CRM pipeline.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max deals to return (default 20) |
Returns: A list of - **<name>** $<amount> | Stage: <stage> | Close: <date> id: <id> lines, or "No deals found.".
hubspot_create_deal
Create a new deal in HubSpot CRM.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Deal name |
amount | string | No | Deal amount (e.g. 5000) |
stage | string | No | Deal stage ID (e.g. appointmentscheduled) |
close_date | string | No | Expected close date (YYYY-MM-DD) |
pipeline | string | No | Pipeline ID (default: default) |
Returns: "Deal created: **<name>** ID: <id>".
hubspot_create_note
Create a note in HubSpot and optionally associate it with a contact or deal.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | string | Yes | Note content |
contact_id | string | No | Associate note with this contact ID |
deal_id | string | No | Associate note with this deal ID |
Returns: "Note created. ID: <id>".