HubSpot
HubSpot CRM integration for contacts, deals, companies, and lists
The HubSpot integration lets your agents manage CRM objects — contacts, deals, companies — and search across your HubSpot data.
Prerequisites
You need one of the following:
- Private App Access Token — In HubSpot, go to Settings → Integrations → Private Apps, create a new app, select the required scopes (e.g.,
crm.objects.contacts.read,crm.objects.deals.read), and copy the access token. - OAuth — For user-level access where each chat user authorizes with their own HubSpot account.
Setup
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select HubSpot from the integration list
- Give the config a display name (e.g., "HubSpot - Sales CRM")
- Choose your authentication method:
- Private App Token — Paste your HubSpot private app access token
- OAuth — Click Connect to start the HubSpot OAuth flow
- Save the agent revision
Using in Your Agent
- In an Agent Step, attach HubSpot tools from the tools panel
- The agent uses your integration config for all HubSpot API calls
- Tools are referenced as
hubspot.get_contacts,hubspot.create_deal, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
get_contacts | List contacts from HubSpot CRM | ReadOnly |
get_contact | Get a single contact by ID or email | ReadOnly |
create_contact | Create a new contact | Reversible |
update_contact | Update an existing contact's properties | Reversible |
get_deals | List deals from HubSpot CRM | ReadOnly |
get_deal | Get a single deal by ID | ReadOnly |
create_deal | Create a new deal | Reversible |
update_deal | Update an existing deal's properties | Reversible |
get_companies | List companies from HubSpot CRM | ReadOnly |
get_company | Get a single company by ID | ReadOnly |
create_company | Create a new company | Reversible |
update_company | Update an existing company's properties | Reversible |
search_crm | Search across HubSpot CRM objects | ReadOnly |
get_lists | Get all contact lists | ReadOnly |
get_list_contacts | Get contacts that are members of a specific list | ReadOnly |