Skip to Content

HubSpot

HubSpot icon
Arcade Optimized

Arcade tools designed for LLMs to interact with Hubspot

Author:Arcade
Version:3.0.0
Auth:User authorization
40tools
PyPI VersionPython VersionsWheel StatusDownloadsLicense

Arcade 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)

40 of 40
Tool nameDescriptionSecrets
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.
Page 1 of 2(25 of 40)

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

ParameterTypeReq.Description
activity_typestringRequiredEngagement activity type.
notecallemailmeetingtaskcommunication
activity_idintegerRequiredThe activity object ID
deal_idintegerRequiredThe deal ID to associate to

Requirements

No secrets required

Output

Type:json— Associate an activity to a deal
#

Hubspot.AssociateContactToDeal

Associate a contact with an existing deal in HubSpot.

Parameters

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to associate the contact with
contact_idintegerRequiredThe ID of the contact to associate with the deal

Requirements

No secrets required

Output

Type:json— Dictionary containing the association result
#

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

ParameterTypeReq.Description
titlestringRequiredShort title for the call.
when_occurredstringRequiredWhen the call occurred (ISO date format: YYYY-MM-DDTHH:MM:SS).
directionstringOptionalCall direction (INBOUND or OUTBOUND).
INBOUNDOUTBOUND
summarystringOptionalShort summary/notes of the call.
durationintegerOptionalCall duration in seconds.
to_numberstringOptionalPhone number called to.
from_numberstringOptionalPhone number called from.
associate_to_contact_idintegerOptionalContact ID to associate this call with.
associate_to_company_idintegerOptionalCompany ID to associate this call with.
associate_to_deal_idintegerOptionalDeal ID to associate this call with.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
channelstringRequiredCommunication channel type.
SMSWHATS_APPLINKEDIN_MESSAGEPHYSICAL_MAILCUSTOM_CHANNEL_CONVERSATION
when_occurredstringRequiredWhen the communication occurred (ISO date format: YYYY-MM-DDTHH:MM:SS).
body_textstringOptionalFull message content.
associate_to_contact_idintegerOptionalContact ID to associate this communication with.
associate_to_company_idintegerOptionalCompany ID to associate this communication with.
associate_to_deal_idintegerOptionalDeal ID to associate this communication with.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
company_namestringRequiredThe company name (required)
web_domainstringOptionalThe company web domain (e.g., example.com)
industry_typestringOptionalThe company industry type (case-insensitive).
company_citystringOptionalThe company city location
company_statestringOptionalThe company state or province
company_countrystringOptionalThe company country
phone_numberstringOptionalThe company main phone number
website_urlstringOptionalThe company website URL

Requirements

No secrets required

Output

Type:json— Dictionary containing the created company information
#

Hubspot.CreateContact

Create a contact associated with a company.

Parameters

ParameterTypeReq.Description
company_idintegerRequiredThe ID of the company to create the contact for.
first_namestringRequiredThe first name of the contact.
last_namestringOptionalThe last name of the contact.
emailstringOptionalThe email address of the contact.
phonestringOptionalThe phone number of the contact.
mobile_phonestringOptionalThe mobile phone number of the contact.
job_titlestringOptionalThe job title of the contact.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
deal_namestringRequiredThe deal name (required)
deal_amountnumberOptionalThe deal amount/value
deal_stagestringOptionalThe deal stage
deal_typestringOptionalThe deal type.
newbusinessexistingbusiness
expected_close_datestringOptionalExpected close date in YYYY-MM-DD format
pipeline_idstringOptionalPipeline id. Use 'default' for default pipeline or pass a pipeline id (integer)
deal_ownerstringOptionalThe deal owner user ID
priority_levelstringOptionalPriority level.
lowmediumhigh
deal_descriptionstringOptionalThe deal description

Requirements

No secrets required

Output

Type:json— Dictionary containing the created deal information
#

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

ParameterTypeReq.Description
subjectstringRequiredEmail subject.
when_occurredstringRequiredWhen the email occurred (ISO date format: YYYY-MM-DDTHH:MM:SS).
from_emailstringRequiredSender email address.
to_emailstringRequiredPrimary recipient email address.
body_textstringOptionalEmail body in plain text.
body_htmlstringOptionalEmail body in HTML format.
from_first_namestringOptionalSender first name.
from_last_namestringOptionalSender last name.
to_first_namestringOptionalPrimary recipient first name.
to_last_namestringOptionalPrimary recipient last name.
cc_emailsarray<string>OptionalCC recipient email addresses.
bcc_emailsarray<string>OptionalBCC recipient email addresses.
directionstringOptionalDirection the email was sent (EMAIL, INCOMING_EMAIL, FORWARDED_EMAIL).
EMAILINCOMING_EMAILFORWARDED_EMAIL
statusstringOptionalEmail status indicating the state of the email.
BOUNCEDFAILEDSCHEDULEDSENDINGSENT
associate_to_contact_idintegerOptionalContact ID to associate this email with.
associate_to_company_idintegerOptionalCompany ID to associate this email with.
associate_to_deal_idintegerOptionalDeal ID to associate this email with.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
titlestringRequiredMeeting title.
start_datestringRequiredStart date (YYYY-MM-DD format).
start_timestringRequiredStart time (HH:MM or HH:MM:SS format).
durationstringOptionalMeeting duration in HH:MM format (e.g., 1:30 for 1 hour 30 minutes).
locationstringOptionalMeeting location.
outcomestringOptionalMeeting outcome.
SCHEDULEDCOMPLETEDRESCHEDULEDNO_SHOWCANCELED
associate_to_contact_idintegerOptionalContact ID to associate this meeting with.
associate_to_company_idintegerOptionalCompany ID to associate this meeting with.
associate_to_deal_idintegerOptionalDeal ID to associate this meeting with.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
bodystringRequiredThe note content/body.
when_occurredstringRequiredWhen the note was created (ISO date format: YYYY-MM-DDTHH:MM:SS).
associate_to_contact_idintegerOptionalContact ID to associate this note with.
associate_to_company_idintegerOptionalCompany ID to associate this note with.
associate_to_deal_idintegerOptionalDeal ID to associate this note with.

Requirements

No secrets required

Output

Type: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

No secrets required

Output

Type: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

No secrets required

Output

Type:array— List of all available industry types for HubSpot companies.
#

Hubspot.GetCallDataByKeywords

Search for call activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in CALL properties.
limitintegerOptionalThe maximum number of calls to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:json— Retrieve call activity data with associated contacts, companies, and deals.
#

Hubspot.GetCommunicationDataByKeywords

Search for communication activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in COMMUNICATION properties.
limitintegerOptionalThe maximum number of communications to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
keywordsstringRequiredThe keywords to search for companies. It will match against the company name, phone, and website.
limitintegerOptionalThe maximum number of companies to return. Defaults to 10. Max is 10.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
keywordsstringRequiredThe keywords to search for contacts. It will match against the contact's first and last name, email addresses, phone numbers, and company name.
limitintegerOptionalThe maximum number of contacts to return. Defaults to 10. Max is 100.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to retrieve
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.

Requirements

No secrets required

Output

Type:json— Deal information with associated entities
#

Hubspot.GetDealDataByKeywords

Retrieve deal data with associated contacts, companies, calls, emails, meetings, notes, and tasks.

Parameters

ParameterTypeReq.Description
keywordsstringRequiredThe keywords to search for deals. It will match against the deal name and description.
limitintegerOptionalThe maximum number of deals to return. Defaults to 10. Max is 10.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
searchstringOptionalOptional case-insensitive search string to filter pipelines by id or label

Requirements

No secrets required

Output

Type:json— List up to 30 deal pipelines with their stages
#

Hubspot.GetDealPipelineStages

List stages for a specific HubSpot deal pipeline. Useful to get the stage IDs for a specific pipeline.

Parameters

ParameterTypeReq.Description
pipeline_idstringRequiredThe pipeline id (e.g., 'default' or a pipeline GUID)

Requirements

No secrets required

Output

Type:json— List stages for a specific deal pipeline
#

Hubspot.GetEmailDataByKeywords

Search for email activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in EMAIL properties.
limitintegerOptionalThe maximum number of emails to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:json— Retrieve email activity data with associated contacts, companies, and deals.
#

Hubspot.GetMeetingDataByKeywords

Search for meeting activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in MEETING properties.
limitintegerOptionalThe maximum number of meetings to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:json— Retrieve meeting activity data with associated contacts, companies, and deals.
#

Hubspot.GetNoteDataByKeywords

Search for note activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in NOTE properties.
limitintegerOptionalThe maximum number of notes to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type:json— Retrieve note activity data with associated contacts, companies, and deals.
#

Hubspot.GetTaskDataByKeywords

Search for task activities with associated contacts, companies, and deals.

Parameters

ParameterTypeReq.Description
search_termsstringRequiredSearch phrase or terms to find in TASK properties.
limitintegerOptionalThe maximum number of tasks to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
truncate_big_stringsbooleanOptionalWhether to truncate string properties longer than 100 characters. Defaults to False.
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
owner_idintegerRequiredThe HubSpot owner/user ID to retrieve

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
limitintegerOptionalThe maximum number of companies to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
sort_orderstringOptionalSort order for results. Defaults to LATEST_MODIFIED.
LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
limitintegerOptionalThe maximum number of contacts to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
company_idintegerOptionalFilter contacts by company ID. Defaults to None (no filtering).
deal_idintegerOptionalFilter contacts by deal ID. Defaults to None (no filtering).
sort_orderstringOptionalSort order for results. Defaults to LATEST_MODIFIED.
LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
limitintegerOptionalThe maximum number of deals to return. Defaults to 10. Max is 50.
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
contact_idintegerOptionalFilter deals by contact ID. Defaults to None (no filtering).
company_idintegerOptionalFilter deals by company ID. Defaults to None (no filtering).
sort_orderstringOptionalSort order for results. Defaults to LATEST_MODIFIED.
LATEST_MODIFIEDOLDEST_MODIFIEDALPHABETICAL
next_page_tokenstringOptionalThe token to get the next page of results. Defaults to None (returns first page of results)

Requirements

No secrets required

Output

Type: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

No secrets required

Output

Type:json— List of guidance.
#

Hubspot.UpdateCallActivity

Update a call activity directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
call_idintegerOptionalThe call activity ID to update.
keywordsstringOptionalKeywords to search for call summaries or titles. Provide when call_id is not known.
titlestringOptionalUpdated call title.
directionstringOptionalUpdated call direction.
INBOUNDOUTBOUND
summarystringOptionalUpdated call summary.
durationintegerOptionalUpdated call duration in seconds.
to_numberstringOptionalUpdated number called to.
from_numberstringOptionalUpdated number called from.
when_occurredstringOptionalUpdated call timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of calls to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
communication_idintegerOptionalThe communication activity ID to update.
keywordsstringOptionalKeywords to search for communication body text. Provide when communication_id is not known.
channelstringOptionalUpdated communication channel.
SMSWHATS_APPLINKEDIN_MESSAGEPHYSICAL_MAILCUSTOM_CHANNEL_CONVERSATION
body_textstringOptionalUpdated message body.
when_occurredstringOptionalUpdated timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of communications to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
company_idintegerOptionalThe ID of the company to update.
keywordsstringOptionalKeywords to search for the company (name, domain, website). Provide when company_id is not known.
company_namestringOptionalThe company name.
web_domainstringOptionalThe company web domain (e.g., example.com).
industry_typestringOptionalThe company industry type (case-insensitive).
company_citystringOptionalThe company city location.
company_statestringOptionalThe company state or province.
company_countrystringOptionalThe company country.
phone_numberstringOptionalThe company main phone number.
website_urlstringOptionalThe company website URL.
matches_limitintegerOptionalThe maximum number of companies to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
contact_idintegerOptionalThe ID of the contact to update.
keywordsstringOptionalKeywords to search for the contact (name, email, phone). Provide when contact_id is not known.
first_namestringOptionalThe first name of the contact.
last_namestringOptionalThe last name of the contact.
emailstringOptionalThe email address of the contact.
phonestringOptionalThe phone number of the contact.
mobile_phonestringOptionalThe mobile phone number of the contact.
job_titlestringOptionalThe job title of the contact.
matches_limitintegerOptionalThe maximum number of contacts to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
deal_idintegerOptionalThe ID of the deal to update.
keywordsstringOptionalKeywords to search for the deal (name, description). Provide when deal_id is not known.
deal_namestringOptionalThe deal name.
deal_amountnumberOptionalThe deal amount/value.
deal_stagestringOptionalThe deal stage ID.
deal_typestringOptionalThe deal type. Accepts enum values as strings (e.g., 'newbusiness', 'existingbusiness').
expected_close_datestringOptionalExpected close date in YYYY-MM-DD format.
deal_ownerstringOptionalThe deal owner user ID.
priority_levelstringOptionalPriority level. Accepts enum values as strings (e.g., 'low', 'medium', 'high').
deal_descriptionstringOptionalThe deal description.
matches_limitintegerOptionalThe maximum number of deals to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to update
expected_close_datestringRequiredNew expected close date in YYYY-MM-DD format
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.

Requirements

No secrets required

Output

Type:json— Updated deal information with associated entities
#

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

ParameterTypeReq.Description
deal_idintegerRequiredThe ID of the deal to update
deal_stagestringRequiredNew deal stage ID
associations_limitintegerOptionalThe maximum number of each associated object type to return. Defaults to 10.
current_pipeline_idstringOptionalCurrent pipeline id for this deal, if already known (skips fetching the deal)
allow_pipeline_changebooleanOptionalIf true, allows changing the deal's pipeline when the stage belongs to another pipeline

Requirements

No secrets required

Output

Type:json— Updated deal information with associated entities
#

Hubspot.UpdateEmailActivity

Update an email activity directly by ID or surface matches when searching by keywords.

Parameters

ParameterTypeReq.Description
email_idintegerOptionalThe email activity ID to update.
keywordsstringOptionalKeywords to search for email subjects or body text. Provide when email_id is not known.
subjectstringOptionalUpdated email subject.
directionstringOptionalUpdated email direction.
EMAILINCOMING_EMAILFORWARDED_EMAIL
statusstringOptionalUpdated email status.
BOUNCEDFAILEDSCHEDULEDSENDINGSENT
body_textstringOptionalUpdated plain-text body.
body_htmlstringOptionalUpdated HTML body.
when_occurredstringOptionalUpdated email timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of emails to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
meeting_idintegerOptionalThe meeting activity ID to update.
keywordsstringOptionalKeywords to search for meeting titles. Provide when meeting_id is not known.
titlestringOptionalUpdated meeting title.
start_datestringOptionalUpdated start date (YYYY-MM-DD).
start_timestringOptionalUpdated start time (HH:MM or HH:MM:SS).
durationstringOptionalUpdated duration in HH:MM format.
locationstringOptionalUpdated meeting location.
outcomestringOptionalUpdated meeting outcome.
SCHEDULEDCOMPLETEDRESCHEDULEDNO_SHOWCANCELED
matches_limitintegerOptionalMaximum number of meetings to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

ParameterTypeReq.Description
note_idintegerOptionalThe note ID to update.
keywordsstringOptionalKeywords to search for the note content. Provide when note_id is not known.
bodystringOptionalUpdated note content.
when_occurredstringOptionalUpdated creation timestamp (ISO format: YYYY-MM-DDTHH:MM:SS).
matches_limitintegerOptionalMaximum number of notes to return when searching by keywords. Defaults to 5. Max is 20.

Requirements

No secrets required

Output

Type: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

No secrets required

Output

Type:json— Get current user information.
Last updated on