Tools

HubSpot

Interact with HubSpot CRM or trigger workflows from HubSpot events

Usage Instructions

Integrate HubSpot into your workflow. Manage contacts, companies, deals, tickets, and other CRM objects with powerful automation capabilities. Can be used in trigger mode to start workflows when contacts are created, deleted, or updated.

Tools

`hubspot_get_users`

Retrieve all users from HubSpot account

Input

Parameter	Type	Required	Description
`limit`	string	No	Number of results to return (default: 100)

Output

Parameter	Type	Description
`users`	array	Array of HubSpot user objects
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_list_contacts`

Retrieve all contacts from HubSpot account with pagination support

Input

Parameter	Type	Required	Description
`limit`	string	No	Maximum number of results per page (max 100, default 100)
`after`	string	No	Pagination cursor for next page of results
`properties`	string	No	Comma-separated list of properties to return (e.g., "email,firstname,lastname")
`associations`	string	No	Comma-separated list of object types to retrieve associated IDs for

Output

Parameter	Type	Description
`contacts`	array	Array of HubSpot contact objects
`paging`	object	Pagination information
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_get_contact`

Retrieve a single contact by ID or email from HubSpot

Input

Parameter	Type	Required	Description
`contactId`	string	Yes	The ID or email of the contact to retrieve
`idProperty`	string	No	Property to use as unique identifier (e.g., "email"). If not specified, uses record ID
`properties`	string	No	Comma-separated list of properties to return
`associations`	string	No	Comma-separated list of object types to retrieve associated IDs for

Output

Parameter	Type	Description
`contact`	object	HubSpot contact object with properties
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_create_contact`

Create a new contact in HubSpot. Requires at least one of: email, firstname, or lastname

Input

Parameter	Type	Required	Description
`properties`	object	Yes	Contact properties as JSON object. Must include at least one of: email, firstname, or lastname
`associations`	array	No	Array of associations to create with the contact (e.g., companies, deals). Each object should have "to" (with "id") and "types" (with "associationCategory" and "associationTypeId")

Output

Parameter	Type	Description
`contact`	object	Created HubSpot contact object
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_update_contact`

Update an existing contact in HubSpot by ID or email

Input

Parameter	Type	Required	Description
`contactId`	string	Yes	The ID or email of the contact to update
`idProperty`	string	No	Property to use as unique identifier (e.g., "email"). If not specified, uses record ID
`properties`	object	Yes	Contact properties to update as JSON object

Output

Parameter	Type	Description
`contact`	object	Updated HubSpot contact object
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_search_contacts`

Search for contacts in HubSpot using filters, sorting, and queries

Input

Parameter	Type	Required	Description
`filterGroups`	array	No	Array of filter groups. Each group contains filters with propertyName, operator, and value
`sorts`	array	No	Array of sort objects with propertyName and direction ("ASCENDING" or "DESCENDING")
`query`	string	No	Search query string
`properties`	array	No	Array of property names to return
`limit`	number	No	Maximum number of results to return (max 100)
`after`	string	No	Pagination cursor for next page

Output

Parameter	Type	Description
`contacts`	array	Array of matching HubSpot contact objects
`total`	number	Total number of matching contacts
`paging`	object	Pagination information
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_list_companies`

Retrieve all companies from HubSpot account with pagination support

Input

Parameter	Type	Required	Description
`limit`	string	No	Maximum number of results per page (max 100, default 100)
`after`	string	No	Pagination cursor for next page of results
`properties`	string	No	Comma-separated list of properties to return
`associations`	string	No	Comma-separated list of object types to retrieve associated IDs for

Output

Parameter	Type	Description
`companies`	array	Array of HubSpot company objects
`paging`	object	Pagination information
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_get_company`

Retrieve a single company by ID or domain from HubSpot

Input

Parameter	Type	Required	Description
`companyId`	string	Yes	The ID or domain of the company to retrieve
`idProperty`	string	No	Property to use as unique identifier (e.g., "domain"). If not specified, uses record ID
`properties`	string	No	Comma-separated list of properties to return
`associations`	string	No	Comma-separated list of object types to retrieve associated IDs for

Output

Parameter	Type	Description
`company`	object	HubSpot company object with properties
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_create_company`

Create a new company in HubSpot

Input

Parameter	Type	Required	Description
`properties`	object	Yes	Company properties as JSON object (e.g., name, domain, city, industry)
`associations`	array	No	Array of associations to create with the company

Output

Parameter	Type	Description
`company`	object	Created HubSpot company object
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_update_company`

Update an existing company in HubSpot by ID or domain

Input

Parameter	Type	Required	Description
`companyId`	string	Yes	The ID or domain of the company to update
`idProperty`	string	No	Property to use as unique identifier (e.g., "domain"). If not specified, uses record ID
`properties`	object	Yes	Company properties to update as JSON object

Output

Parameter	Type	Description
`company`	object	Updated HubSpot company object
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_search_companies`

Search for companies in HubSpot using filters, sorting, and queries

Input

Parameter	Type	Required	Description
`filterGroups`	array	No	Array of filter groups. Each group contains filters with propertyName, operator, and value
`sorts`	array	No	Array of sort objects with propertyName and direction ("ASCENDING" or "DESCENDING")
`query`	string	No	Search query string
`properties`	array	No	Array of property names to return
`limit`	number	No	Maximum number of results to return (max 100)
`after`	string	No	Pagination cursor for next page

Output

Parameter	Type	Description
`companies`	array	Array of matching HubSpot company objects
`total`	number	Total number of matching companies
`paging`	object	Pagination information
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

`hubspot_list_deals`

Retrieve all deals from HubSpot account with pagination support

Input

Parameter	Type	Required	Description
`limit`	string	No	Maximum number of results per page (max 100, default 100)
`after`	string	No	Pagination cursor for next page of results
`properties`	string	No	Comma-separated list of properties to return
`associations`	string	No	Comma-separated list of object types to retrieve associated IDs for

Output

Parameter	Type	Description
`deals`	array	Array of HubSpot deal objects
`paging`	object	Pagination information
`metadata`	object	Operation metadata
`success`	boolean	Operation success status

Triggers

`hubspot_contact_created`

Trigger workflow when a new contact is created in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_contact_deleted`

Trigger workflow when a contact is deleted in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_contact_privacy_deleted`

Trigger workflow when a contact is deleted for privacy compliance (GDPR, CCPA, etc.) in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_contact_property_changed`

Trigger workflow when any property of a contact is updated in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_company_created`

Trigger workflow when a new company is created in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_company_deleted`

Trigger workflow when a company is deleted in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_company_property_changed`

Trigger workflow when any property of a company is updated in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_conversation_creation`

Trigger workflow when a new conversation is created in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_conversation_deletion`

Trigger workflow when a conversation is deleted in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_conversation_new_message`

Trigger workflow when a new message is added to a conversation in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_conversation_privacy_deletion`

Trigger workflow when a conversation is deleted for privacy compliance (GDPR, CCPA, etc.) in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_conversation_property_changed`

Trigger workflow when any property of a conversation is updated in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_deal_created`

Trigger workflow when a new deal is created in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_deal_deleted`

Trigger workflow when a deal is deleted in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_deal_property_changed`

Trigger workflow when any property of a deal is updated in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_ticket_created`

Trigger workflow when a new ticket is created in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_ticket_deleted`

Trigger workflow when a ticket is deleted in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

`hubspot_ticket_property_changed`

Trigger workflow when any property of a ticket is updated in HubSpot

Output

Parameter	Type	Description
`payload`	json	Full webhook payload array from HubSpot containing event details
`provider`	string	Provider name (hubspot)
`providerConfig.appId`	string	HubSpot App ID
`providerConfig.clientId`	string	HubSpot Client ID
`providerConfig.triggerId`	string	Trigger ID (e.g., hubspot_company_created)
`providerConfig.clientSecret`	string	HubSpot Client Secret
`providerConfig.developerApiKey`	string	HubSpot Developer API Key
`providerConfig.curlSetWebhookUrl`	string	curl command to set webhook URL
`providerConfig.curlCreateSubscription`	string	curl command to create subscription
`providerConfig.webhookUrlDisplay`	string	Webhook URL display value
`providerConfig.propertyName`	string	Optional property name filter (for property change triggers)

Notes

Category: tools
Type: hubspot

Hex Hugging Face

On this page

On this page

Usage Instructions

hubspot_get_users

hubspot_list_contacts

hubspot_get_contact

hubspot_create_contact

hubspot_update_contact

hubspot_search_contacts

hubspot_list_companies

hubspot_get_company

hubspot_create_company

hubspot_update_company

hubspot_search_companies

hubspot_list_deals

hubspot_contact_created

hubspot_contact_deleted

hubspot_contact_privacy_deleted

hubspot_contact_property_changed

hubspot_company_created

hubspot_company_deleted

hubspot_company_property_changed

hubspot_conversation_creation

hubspot_conversation_deletion

hubspot_conversation_new_message

hubspot_conversation_privacy_deletion

hubspot_conversation_property_changed

hubspot_deal_created

hubspot_deal_deleted

hubspot_deal_property_changed

hubspot_ticket_created

hubspot_ticket_deleted

hubspot_ticket_property_changed

HubSpot