HubSpot
Arcade tools designed for LLMs to interact with Hubspot
3.0.0Arcade Toolkit for HubSpot enables seamless integration and interaction with HubSpot's CRM functionalities, allowing developers to leverage various activities and data management tools for enhanced customer relationship management.
Capabilities
- Create, update, and manage companies, contacts, and deals within HubSpot.
- Log and associate various engagement activities such as calls, emails, meetings, and more.
- Retrieve detailed information about users, deals, and associated data effectively.
- Access industry types and manage user assignments efficiently.
OAuth
- Provider: Unknown
- Scopes: crm.objects.companies.read, crm.objects.contacts.write, crm.objects.deals.read, oauth, sales-email-read
Secrets
- No existing secrets.
Available tools(40)
| Tool name | Description | Secrets | |
|---|---|---|---|
Associate a single activity object to a deal using HubSpot standard association type. | |||
Associate a contact with an existing deal in HubSpot. | |||
Create a call engagement activity with required owner and associations.
Must be associated with at least one of: contact, company, or deal.
Assign to the current user if not specified otherwise. | |||
Create a communication activity for logging communications that are not done via
email, call, or meeting.
This includes SMS, WhatsApp, LinkedIn messages, physical mail, and custom channel
conversations.
Must be associated with at least one of: contact, company, or deal.
The communication will be assigned to the current user. | |||
Create a new company in HubSpot.
Before calling this tool, use Hubspot.GetAvailableIndustryTypes to see valid values. | |||
Create a contact associated with a company. | |||
Create a new deal in HubSpot.
If pipeline_id is not provided, the default pipeline will be used.
For custom pipelines, deal_stage must be a valid stage ID within
the selected pipeline. If deal_stage is not specified,
the first stage in the pipeline will be used automatically.
It is recommended have already pipeline data available when
planning to call this tool. | |||
Create a logged email engagement activity with essential fields including email headers.
Must be associated with at least one of: contact, company, or deal.
The email will be assigned to the current user. | |||
Create a meeting with essential fields including separate date and time.
The start_date and start_time are combined to create the meeting timestamp.
Duration can be specified in HH:MM format.
Must be associated with at least one of: contact, company, or deal.
The meeting will be assigned to the current user. | |||
Create a note engagement activity with required owner and associations.
Must be associated with at least one of: contact, company, or deal.
Assign to the current user if not specified otherwise. | |||
Get all users/owners in the HubSpot portal.
This tool retrieves a list of all users (owners) in your HubSpot portal,
Useful for user management and assignment operations.
Use this tool when needing information about ALL users in the HubSpot portal. | |||
Get all available industry types for HubSpot companies.
Returns a sorted list of valid industry type values that can be used
when creating companies. | |||
Search for call activities with associated contacts, companies, and deals. | |||
Search for communication activities with associated contacts, companies, and deals. | |||
Retrieve company data with associated contacts, deals, calls, emails,
meetings, notes, and tasks. | |||
Retrieve contact data with associated companies, deals, calls, emails,
meetings, notes, and tasks. | |||
Retrieve a specific deal by its ID with associated contacts, companies, calls, emails,
meetings, notes, and tasks. | |||
Retrieve deal data with associated contacts, companies, calls, emails,
meetings, notes, and tasks. | |||
List HubSpot deal pipelines with their stages, optionally filtered by a search string.
Recommended to be used before creating a new deal.
For example updating the stage of a deal without changing the pipeline. | |||
List stages for a specific HubSpot deal pipeline.
Useful to get the stage IDs for a specific pipeline. | |||
Search for email activities with associated contacts, companies, and deals. | |||
Search for meeting activities with associated contacts, companies, and deals. | |||
Search for note activities with associated contacts, companies, and deals. | |||
Search for task activities with associated contacts, companies, and deals. | |||
Get detailed information about a specific user/owner by their ID.
This tool retrieves comprehensive information about a specific user
in your HubSpot portal using their owner ID. |
Selected tools
No tools selected.
Click "Show all tools" to add tools.
Requirements
Select tools to see requirements
Hubspot.AssociateActivityToDeal
Associate a single activity object to a deal using HubSpot standard association type.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
activity_type | string | Required | Engagement activity type.notecallemailmeetingtaskcommunication |
activity_id | integer | Required | The activity object ID |
deal_id | integer | Required | The deal ID to associate to |
Requirements
Output
json— Associate an activity to a dealHubspot.AssociateContactToDeal
Associate a contact with an existing deal in HubSpot.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
deal_id | integer | Required | The ID of the deal to associate the contact with |
contact_id | integer | Required | The ID of the contact to associate with the deal |
Requirements
Output
json— Dictionary containing the association resultHubspot.CreateCallActivity
Create a call engagement activity with required owner and associations. Must be associated with at least one of: contact, company, or deal. Assign to the current user if not specified otherwise.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
title | string | Required | Short title for the call. |
when_occurred | string | Required | When the call occurred (ISO date format: YYYY-MM-DDTHH:MM:SS). |
direction | string | Optional | Call direction (INBOUND or OUTBOUND).INBOUNDOUTBOUND |
summary | string | Optional | Short summary/notes of the call. |
duration | integer | Optional | Call duration in seconds. |
to_number | string | Optional | Phone number called to. |
from_number | string | Optional | Phone number called from. |
associate_to_contact_id | integer | Optional | Contact ID to associate this call with. |
associate_to_company_id | integer | Optional | Company ID to associate this call with. |
associate_to_deal_id | integer | Optional | Deal ID to associate this call with. |
Requirements
Output
json— Details of the call engagement activity created.Hubspot.CreateCommunicationActivity
Create a communication activity for logging communications that are not done via email, call, or meeting. This includes SMS, WhatsApp, LinkedIn messages, physical mail, and custom channel conversations. Must be associated with at least one of: contact, company, or deal. The communication will be assigned to the current user.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
channel | string | Required | Communication channel type.SMSWHATS_APPLINKEDIN_MESSAGEPHYSICAL_MAILCUSTOM_CHANNEL_CONVERSATION |
when_occurred | string | Required | When the communication occurred (ISO date format: YYYY-MM-DDTHH:MM:SS). |
body_text | string | Optional | Full message content. |
associate_to_contact_id | integer | Optional | Contact ID to associate this communication with. |
associate_to_company_id | integer | Optional | Company ID to associate this communication with. |
associate_to_deal_id | integer | Optional | Deal ID to associate this communication with. |
Requirements
Output
json— Details of the communication engagement activity created.Hubspot.CreateCompany
Create a new company in HubSpot. Before calling this tool, use Hubspot.GetAvailableIndustryTypes to see valid values.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
company_name | string | Required | The company name (required) |
web_domain | string | Optional | The company web domain (e.g., example.com) |
industry_type | string | Optional | The company industry type (case-insensitive). |
company_city | string | Optional | The company city location |
company_state | string | Optional | The company state or province |
company_country | string | Optional | The company country |
phone_number | string | Optional | The company main phone number |
website_url | string | Optional | The company website URL |
Requirements
Output
json— Dictionary containing the created company informationHubspot.CreateContact
Create a contact associated with a company.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
company_id | integer | Required | The ID of the company to create the contact for. |
first_name | string | Required | The first name of the contact. |
last_name | string | Optional | The last name of the contact. |
email | string | Optional | The email address of the contact. |
phone | string | Optional | The phone number of the contact. |
mobile_phone | string | Optional | The mobile phone number of the contact. |
job_title | string | Optional | The job title of the contact. |
Requirements
Output
json— Create a contact associated with a company.Hubspot.CreateDeal
Create a new deal in HubSpot. If pipeline_id is not provided, the default pipeline will be used. For custom pipelines, deal_stage must be a valid stage ID within the selected pipeline. If deal_stage is not specified, the first stage in the pipeline will be used automatically. It is recommended have already pipeline data available when planning to call this tool.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
deal_name | string | Required | The deal name (required) |
deal_amount | number | Optional | The deal amount/value |
deal_stage | string | Optional | The deal stage |
deal_type | string | Optional | The deal type.newbusinessexistingbusiness |
expected_close_date | string | Optional | Expected close date in YYYY-MM-DD format |
pipeline_id | string | Optional | Pipeline id. Use 'default' for default pipeline or pass a pipeline id (integer) |
deal_owner | string | Optional | The deal owner user ID |
priority_level | string | Optional | Priority level.lowmediumhigh |
deal_description | string | Optional | The deal description |
Requirements
Output
json— Dictionary containing the created deal informationHubspot.CreateEmailActivity
Create a logged email engagement activity with essential fields including email headers. Must be associated with at least one of: contact, company, or deal. The email will be assigned to the current user.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
subject | string | Required | Email subject. |
when_occurred | string | Required | When the email occurred (ISO date format: YYYY-MM-DDTHH:MM:SS). |
from_email | string | Required | Sender email address. |
to_email | string | Required | Primary recipient email address. |
body_text | string | Optional | Email body in plain text. |
body_html | string | Optional | Email body in HTML format. |
from_first_name | string | Optional | Sender first name. |
from_last_name | string | Optional | Sender last name. |
to_first_name | string | Optional | Primary recipient first name. |
to_last_name | string | Optional | Primary recipient last name. |
cc_emails | array<string> | Optional | CC recipient email addresses. |
bcc_emails | array<string> | Optional | BCC recipient email addresses. |
direction | string | Optional | Direction the email was sent (EMAIL, INCOMING_EMAIL, FORWARDED_EMAIL).EMAILINCOMING_EMAILFORWARDED_EMAIL |
status | string | Optional | Email status indicating the state of the email.BOUNCEDFAILEDSCHEDULEDSENDINGSENT |
associate_to_contact_id | integer | Optional | Contact ID to associate this email with. |
associate_to_company_id | integer | Optional | Company ID to associate this email with. |
associate_to_deal_id | integer | Optional | Deal ID to associate this email with. |
Requirements
Output
json— Details of the email engagement activity created.Hubspot.CreateMeetingActivity
Create a meeting with essential fields including separate date and time. The start_date and start_time are combined to create the meeting timestamp. Duration can be specified in HH:MM format. Must be associated with at least one of: contact, company, or deal. The meeting will be assigned to the current user.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
title | string | Required | Meeting title. |
start_date | string | Required | Start date (YYYY-MM-DD format). |
start_time | string | Required | Start time (HH:MM or HH:MM:SS format). |
duration | string | Optional | Meeting duration in HH:MM format (e.g., 1:30 for 1 hour 30 minutes). |
location | string | Optional | Meeting location. |
outcome | string | Optional | Meeting outcome.SCHEDULEDCOMPLETEDRESCHEDULEDNO_SHOWCANCELED |
associate_to_contact_id | integer | Optional | Contact ID to associate this meeting with. |
associate_to_company_id | integer | Optional | Company ID to associate this meeting with. |
associate_to_deal_id | integer | Optional | Deal ID to associate this meeting with. |
Requirements
Output
json— Details of the meeting engagement activity created.Hubspot.CreateNoteActivity
Create a note engagement activity with required owner and associations. Must be associated with at least one of: contact, company, or deal. Assign to the current user if not specified otherwise.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
body | string | Required | The note content/body. |
when_occurred | string | Required | When the note was created (ISO date format: YYYY-MM-DDTHH:MM:SS). |
associate_to_contact_id | integer | Optional | Contact ID to associate this note with. |
associate_to_company_id | integer | Optional | Company ID to associate this note with. |
associate_to_deal_id | integer | Optional | Deal ID to associate this note with. |
Requirements
Output
json— Details of the note engagement activity created.Hubspot.GetAllUsers
Get all users/owners in the HubSpot portal. This tool retrieves a list of all users (owners) in your HubSpot portal, Useful for user management and assignment operations. Use this tool when needing information about ALL users in the HubSpot portal.
Parameters
No parameters required.
Requirements
Output
json— Get all users/owners in the HubSpot portal with their names, emails, IDs, and status.Hubspot.GetAvailableIndustryTypes
Get all available industry types for HubSpot companies. Returns a sorted list of valid industry type values that can be used when creating companies.
Parameters
No parameters required.
Requirements
Output
array— List of all available industry types for HubSpot companies.Hubspot.GetCallDataByKeywords
Search for call activities with associated contacts, companies, and deals.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
search_terms | string | Required | Search phrase or terms to find in CALL properties. |
limit | integer | Optional | The maximum number of calls to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
truncate_big_strings | boolean | Optional | Whether to truncate string properties longer than 100 characters. Defaults to False. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve call activity data with associated contacts, companies, and deals.Hubspot.GetCommunicationDataByKeywords
Search for communication activities with associated contacts, companies, and deals.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
search_terms | string | Required | Search phrase or terms to find in COMMUNICATION properties. |
limit | integer | Optional | The maximum number of communications to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
truncate_big_strings | boolean | Optional | Whether to truncate string properties longer than 100 characters. Defaults to False. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve communication activity data with associated contacts, companies, and deals.Hubspot.GetCompanyDataByKeywords
Retrieve company data with associated contacts, deals, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
keywords | string | Required | The keywords to search for companies. It will match against the company name, phone, and website. |
limit | integer | Optional | The maximum number of companies to return. Defaults to 10. Max is 10. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve company data with associated contacts, deals, calls, emails, meetings, notes, and tasks.Hubspot.GetContactDataByKeywords
Retrieve contact data with associated companies, deals, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
keywords | string | Required | The keywords to search for contacts. It will match against the contact's first and last name, email addresses, phone numbers, and company name. |
limit | integer | Optional | The maximum number of contacts to return. Defaults to 10. Max is 100. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve contact data with associated companies, deals, calls, emails, meetings, notes, and tasks.Hubspot.GetDealById
Retrieve a specific deal by its ID with associated contacts, companies, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
deal_id | integer | Required | The ID of the deal to retrieve |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
Requirements
Output
json— Deal information with associated entitiesHubspot.GetDealDataByKeywords
Retrieve deal data with associated contacts, companies, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
keywords | string | Required | The keywords to search for deals. It will match against the deal name and description. |
limit | integer | Optional | The maximum number of deals to return. Defaults to 10. Max is 10. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve deal data with associated contacts, companies, calls, emails, meetings, notes, and tasks.Hubspot.GetDealPipelines
List HubSpot deal pipelines with their stages, optionally filtered by a search string. Recommended to be used before creating a new deal. For example updating the stage of a deal without changing the pipeline.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
search | string | Optional | Optional case-insensitive search string to filter pipelines by id or label |
Requirements
Output
json— List up to 30 deal pipelines with their stagesHubspot.GetDealPipelineStages
List stages for a specific HubSpot deal pipeline. Useful to get the stage IDs for a specific pipeline.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
pipeline_id | string | Required | The pipeline id (e.g., 'default' or a pipeline GUID) |
Requirements
Output
json— List stages for a specific deal pipelineHubspot.GetEmailDataByKeywords
Search for email activities with associated contacts, companies, and deals.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
search_terms | string | Required | Search phrase or terms to find in EMAIL properties. |
limit | integer | Optional | The maximum number of emails to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
truncate_big_strings | boolean | Optional | Whether to truncate string properties longer than 100 characters. Defaults to False. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve email activity data with associated contacts, companies, and deals.Hubspot.GetMeetingDataByKeywords
Search for meeting activities with associated contacts, companies, and deals.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
search_terms | string | Required | Search phrase or terms to find in MEETING properties. |
limit | integer | Optional | The maximum number of meetings to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
truncate_big_strings | boolean | Optional | Whether to truncate string properties longer than 100 characters. Defaults to False. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve meeting activity data with associated contacts, companies, and deals.Hubspot.GetNoteDataByKeywords
Search for note activities with associated contacts, companies, and deals.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
search_terms | string | Required | Search phrase or terms to find in NOTE properties. |
limit | integer | Optional | The maximum number of notes to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
truncate_big_strings | boolean | Optional | Whether to truncate string properties longer than 100 characters. Defaults to False. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve note activity data with associated contacts, companies, and deals.Hubspot.GetTaskDataByKeywords
Search for task activities with associated contacts, companies, and deals.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
search_terms | string | Required | Search phrase or terms to find in TASK properties. |
limit | integer | Optional | The maximum number of tasks to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
truncate_big_strings | boolean | Optional | Whether to truncate string properties longer than 100 characters. Defaults to False. |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— Retrieve task activity data with associated contacts, companies, and deals.Hubspot.GetUserById
Get detailed information about a specific user/owner by their ID. This tool retrieves comprehensive information about a specific user in your HubSpot portal using their owner ID.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
owner_id | integer | Required | The HubSpot owner/user ID to retrieve |
Requirements
Output
json— Get detailed information about a specific user/owner by their ID.Hubspot.ListCompanies
List companies with associated contacts, deals, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
limit | integer | Optional | The maximum number of companies to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
sort_order | string | Optional | Sort order for results. Defaults to LATEST_MODIFIED.LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— List companies with associated contacts, deals, calls, emails, meetings, notes, and tasks.Hubspot.ListContacts
List contacts with associated companies, deals, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
limit | integer | Optional | The maximum number of contacts to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
company_id | integer | Optional | Filter contacts by company ID. Defaults to None (no filtering). |
deal_id | integer | Optional | Filter contacts by deal ID. Defaults to None (no filtering). |
sort_order | string | Optional | Sort order for results. Defaults to LATEST_MODIFIED.LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— List contacts with associated companies, deals, calls, emails, meetings, notes, and tasks.Hubspot.ListDeals
List deals with associated contacts, companies, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
limit | integer | Optional | The maximum number of deals to return. Defaults to 10. Max is 50. |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
contact_id | integer | Optional | Filter deals by contact ID. Defaults to None (no filtering). |
company_id | integer | Optional | Filter deals by company ID. Defaults to None (no filtering). |
sort_order | string | Optional | Sort order for results. Defaults to LATEST_MODIFIED.LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL |
next_page_token | string | Optional | The token to get the next page of results. Defaults to None (returns first page of results) |
Requirements
Output
json— List deals with associated contacts, companies, calls, emails, meetings, notes, and tasks.Hubspot.ToolkitEnviromentGuidance
Get guidance and considerations for using the HubSpot toolkit effectively. This tool provides important context and best practices for working with HubSpot tools. Based on all available HubSpot toolkit tools, some suggestions may apply to tools that are not available in the current agent's configuration.
Parameters
No parameters required.
Requirements
Output
json— List of guidance.Hubspot.UpdateCallActivity
Update a call activity directly by ID or surface matches when searching by keywords.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
call_id | integer | Optional | The call activity ID to update. |
keywords | string | Optional | Keywords to search for call summaries or titles. Provide when call_id is not known. |
title | string | Optional | Updated call title. |
direction | string | Optional | Updated call direction.INBOUNDOUTBOUND |
summary | string | Optional | Updated call summary. |
duration | integer | Optional | Updated call duration in seconds. |
to_number | string | Optional | Updated number called to. |
from_number | string | Optional | Updated number called from. |
when_occurred | string | Optional | Updated call timestamp (ISO format: YYYY-MM-DDTHH:MM:SS). |
matches_limit | integer | Optional | Maximum number of calls to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update a call by ID or list matching calls when searching by keywords.Hubspot.UpdateCommunicationActivity
Update a communication activity by ID or return matches for keyword searches.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
communication_id | integer | Optional | The communication activity ID to update. |
keywords | string | Optional | Keywords to search for communication body text. Provide when communication_id is not known. |
channel | string | Optional | Updated communication channel.SMSWHATS_APPLINKEDIN_MESSAGEPHYSICAL_MAILCUSTOM_CHANNEL_CONVERSATION |
body_text | string | Optional | Updated message body. |
when_occurred | string | Optional | Updated timestamp (ISO format: YYYY-MM-DDTHH:MM:SS). |
matches_limit | integer | Optional | Maximum number of communications to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update a communication activity by ID or list matching communications when searching by keywords.Hubspot.UpdateCompany
Update a company directly by ID or surface matches when searching by keywords.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
company_id | integer | Optional | The ID of the company to update. |
keywords | string | Optional | Keywords to search for the company (name, domain, website). Provide when company_id is not known. |
company_name | string | Optional | The company name. |
web_domain | string | Optional | The company web domain (e.g., example.com). |
industry_type | string | Optional | The company industry type (case-insensitive). |
company_city | string | Optional | The company city location. |
company_state | string | Optional | The company state or province. |
company_country | string | Optional | The company country. |
phone_number | string | Optional | The company main phone number. |
website_url | string | Optional | The company website URL. |
matches_limit | integer | Optional | The maximum number of companies to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update a company by ID or list matching companies when searching by keywords.Hubspot.UpdateContact
Update a contact directly by ID or list possible matches when searching by keywords.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
contact_id | integer | Optional | The ID of the contact to update. |
keywords | string | Optional | Keywords to search for the contact (name, email, phone). Provide when contact_id is not known. |
first_name | string | Optional | The first name of the contact. |
last_name | string | Optional | The last name of the contact. |
email | string | Optional | The email address of the contact. |
phone | string | Optional | The phone number of the contact. |
mobile_phone | string | Optional | The mobile phone number of the contact. |
job_title | string | Optional | The job title of the contact. |
matches_limit | integer | Optional | The maximum number of contacts to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update a contact by ID or list matching contacts when searching by keywords.Hubspot.UpdateDeal
Update a deal directly by ID or surface matches when searching by keywords.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
deal_id | integer | Optional | The ID of the deal to update. |
keywords | string | Optional | Keywords to search for the deal (name, description). Provide when deal_id is not known. |
deal_name | string | Optional | The deal name. |
deal_amount | number | Optional | The deal amount/value. |
deal_stage | string | Optional | The deal stage ID. |
deal_type | string | Optional | The deal type. Accepts enum values as strings (e.g., 'newbusiness', 'existingbusiness'). |
expected_close_date | string | Optional | Expected close date in YYYY-MM-DD format. |
deal_owner | string | Optional | The deal owner user ID. |
priority_level | string | Optional | Priority level. Accepts enum values as strings (e.g., 'low', 'medium', 'high'). |
deal_description | string | Optional | The deal description. |
matches_limit | integer | Optional | The maximum number of deals to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update a deal by ID or list matching deals when searching by keywords.Hubspot.UpdateDealCloseDate
Update the expected close date of an existing deal with associated contacts, companies, calls, emails, meetings, notes, and tasks.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
deal_id | integer | Required | The ID of the deal to update |
expected_close_date | string | Required | New expected close date in YYYY-MM-DD format |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
Requirements
Output
json— Updated deal information with associated entitiesHubspot.UpdateDealStage
Updates a deal's stage with associated contacts, companies, calls, emails, meetings, notes, and tasks. Send current_pipeline_id to skip fetching the deal. If pipeline changes are allowed, updates the stage and HubSpot may move the deal to another pipeline. It is recommended have already pipeline data available when planning to call this tool.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
deal_id | integer | Required | The ID of the deal to update |
deal_stage | string | Required | New deal stage ID |
associations_limit | integer | Optional | The maximum number of each associated object type to return. Defaults to 10. |
current_pipeline_id | string | Optional | Current pipeline id for this deal, if already known (skips fetching the deal) |
allow_pipeline_change | boolean | Optional | If true, allows changing the deal's pipeline when the stage belongs to another pipeline |
Requirements
Output
json— Updated deal information with associated entitiesHubspot.UpdateEmailActivity
Update an email activity directly by ID or surface matches when searching by keywords.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
email_id | integer | Optional | The email activity ID to update. |
keywords | string | Optional | Keywords to search for email subjects or body text. Provide when email_id is not known. |
subject | string | Optional | Updated email subject. |
direction | string | Optional | Updated email direction.EMAILINCOMING_EMAILFORWARDED_EMAIL |
status | string | Optional | Updated email status.BOUNCEDFAILEDSCHEDULEDSENDINGSENT |
body_text | string | Optional | Updated plain-text body. |
body_html | string | Optional | Updated HTML body. |
when_occurred | string | Optional | Updated email timestamp (ISO format: YYYY-MM-DDTHH:MM:SS). |
matches_limit | integer | Optional | Maximum number of emails to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update an email activity by ID or list matching emails when searching by keywords.Hubspot.UpdateMeetingActivity
Update a meeting activity directly by ID or surface matches when searching by keywords.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
meeting_id | integer | Optional | The meeting activity ID to update. |
keywords | string | Optional | Keywords to search for meeting titles. Provide when meeting_id is not known. |
title | string | Optional | Updated meeting title. |
start_date | string | Optional | Updated start date (YYYY-MM-DD). |
start_time | string | Optional | Updated start time (HH:MM or HH:MM:SS). |
duration | string | Optional | Updated duration in HH:MM format. |
location | string | Optional | Updated meeting location. |
outcome | string | Optional | Updated meeting outcome.SCHEDULEDCOMPLETEDRESCHEDULEDNO_SHOWCANCELED |
matches_limit | integer | Optional | Maximum number of meetings to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update a meeting activity by ID or list matching meetings when searching by keywords.Hubspot.UpdateNoteActivity
Update a note directly by ID or surface matches when searching by keywords.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
note_id | integer | Optional | The note ID to update. |
keywords | string | Optional | Keywords to search for the note content. Provide when note_id is not known. |
body | string | Optional | Updated note content. |
when_occurred | string | Optional | Updated creation timestamp (ISO format: YYYY-MM-DDTHH:MM:SS). |
matches_limit | integer | Optional | Maximum number of notes to return when searching by keywords. Defaults to 5. Max is 20. |
Requirements
Output
json— Update a note by ID or list matching notes when searching by keywords.Hubspot.WhoAmI
Get current user information from HubSpot. This is typically the first tool called to understand the current user context. Use this tool when needing information about the current user basic HubSpot information. and the associated HubSpot portal.
Parameters
No parameters required.
Requirements
Output
json— Get current user information.