Connect to HubSpot CRM. Manage contacts, deals, companies, and marketing automation
Supports authentication: OAuth 2.0
## Set up the agent connector
## Usage
## Tool list
## `hubspot_companies_search`
Search HubSpot companies using full-text search and pagination. Returns matching companies with specified properties.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `after` | string | No | Pagination offset to get results starting from a specific position |
| `filterGroups` | string | No | JSON string containing filter groups for advanced filtering |
| `limit` | number | No | Number of results to return per page (max 100) |
| `properties` | string | No | Comma-separated list of properties to include in the response |
| `query` | string | No | Search term for full-text search across company properties |
## `hubspot_company_create`
Create a new company in HubSpot CRM. Requires a company name as the unique identifier. Supports additional properties like domain, industry, phone, location, and revenue information.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `annualrevenue` | number | No | Annual revenue of the company |
| `city` | string | No | Company city location |
| `country` | string | No | Company country location |
| `description` | string | No | Company description or overview |
| `domain` | string | No | Company website domain |
| `industry` | string | No | Industry type of the company |
| `name` | string | Yes | Company name (required, serves as primary identifier) |
| `numberofemployees` | number | No | Number of employees at the company |
| `phone` | string | No | Company phone number |
| `state` | string | No | Company state or region |
## `hubspot_company_get`
Retrieve details of a specific company from HubSpot by company ID. Returns company properties and associated data.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `company_id` | string | Yes | ID of the company to retrieve |
| `properties` | string | No | Comma-separated list of properties to include in the response |
## `hubspot_contact_create`
Create a new contact in HubSpot CRM. Requires an email address as the unique identifier. Supports additional properties like name, company, phone, and lifecycle stage.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `company` | string | No | Company name where the contact works |
| `email` | string | Yes | Primary email address for the contact (required, serves as unique identifier) |
| `firstname` | string | No | First name of the contact |
| `hs_lead_status` | string | No | Lead status of the contact |
| `jobtitle` | string | No | Job title of the contact |
| `lastname` | string | No | Last name of the contact |
| `lifecyclestage` | string | No | Lifecycle stage of the contact |
| `phone` | string | No | Phone number of the contact |
| `website` | string | No | Personal or company website URL |
## `hubspot_contact_get`
Retrieve details of a specific contact from HubSpot by contact ID. Returns contact properties and associated data.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `contact_id` | string | Yes | ID of the contact to retrieve |
| `properties` | string | No | Comma-separated list of properties to include in the response |
## `hubspot_contact_update`
Update an existing contact in HubSpot CRM by contact ID. Allows updating contact properties like name, email, company, phone, and lifecycle stage.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `contact_id` | string | Yes | ID of the contact to update |
| `props` | `object` | No | Object containing properties like first name, last name, email, company, phone, and job title to update all these should be provided inside props as a JSON object, this is required |
## `hubspot_contacts_list`
Retrieve a list of contacts from HubSpot with filtering and pagination. Returns contact properties and supports pagination through cursor-based navigation.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `after` | string | No | Pagination cursor to get the next set of results |
| `archived` | boolean | No | Whether to include archived contacts in the results |
| `limit` | number | No | Number of results to return per page (max 100) |
| `properties` | string | No | Comma-separated list of properties to include in the response |
## `hubspot_contacts_search`
Search HubSpot contacts using full-text search and pagination. Returns matching contacts with specified properties.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `after` | string | No | Pagination offset to get results starting from a specific position |
| `filterGroups` | string | No | JSON string containing filter groups for advanced filtering |
| `limit` | number | No | Number of results to return per page (max 100) |
| `properties` | string | No | Comma-separated list of properties to include in the response |
| `query` | string | No | Search term for full-text search across contact properties |
## `hubspot_deal_create`
Create a new deal in HubSpot CRM. Requires dealname, amount, and dealstage. Supports additional properties like pipeline, close date, and deal type.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `amount` | number | Yes | Deal amount/value (required) |
| `closedate` | string | No | Expected close date (YYYY-MM-DD format) |
| `dealname` | string | Yes | Name of the deal (required) |
| `dealstage` | string | Yes | Current stage of the deal (required) |
| `dealtype` | string | No | Type of deal |
| `description` | string | No | Deal description |
| `hs_priority` | string | No | Deal priority (HIGH, MEDIUM, LOW) |
| `pipeline` | string | No | Deal pipeline |
## `hubspot_deal_update`
Update an existing deal in HubSpot CRM by deal ID. Allows updating deal properties like name, amount, stage, pipeline, close date, and priority.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `deal_id` | string | Yes | ID of the deal to update |
| `good_deal` | boolean | No | Boolean flag indicating if this is a good deal |
| `properties` | `object` | Yes | Object containing deal properties to update |
## `hubspot_deals_search`
Search HubSpot deals using full-text search and pagination. Returns matching deals with specified properties.
| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `after` | string | No | Pagination offset to get results starting from a specific position |
| `filterGroups` | string | No | JSON string containing filter groups for advanced filtering |
| `limit` | number | No | Number of results to return per page (max 100) |
| `properties` | string | No | Comma-separated list of properties to include in the response |
| `query` | string | No | Search term for full-text search across deal properties |
