HubSpot

CRM integration · 29 node(s) including 1 trigger.

00Overview

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting HubSpot

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Associate

Association: Link Records

hubspot/associate · Action

Link two HubSpot records with the default association, e.g. attach a contact to a company or a deal. Direction is from -> to.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
From Object Type	`string`	Required	contacts
From Record ID	`string`	Required	12345
To Object Type	`string`	Required	companies
To Record ID	`string`	Required	67890

Returns: result, tool_result, success, error

03Company

Company: Create

hubspot/company_create · Action

Create a new company in HubSpot. Set common fields directly or add any other property via Additional Properties. Returns the company ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Name	`string`		Acme Inc
Domain	`string`		acme.com
Industry	`string`		COMPUTER_SOFTWARE
Phone	`string`		+1 555 0100
City	`string`		London
State/Region	`string`		England
Country	`string`		United Kingdom
Website	`string`		https://acme.com
Additional Properties	`key_value_array`		Any other company property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

Company: Delete

hubspot/company_delete · Action

Archive (soft-delete) a HubSpot company by its ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Company ID	`string`	Required	12345

Returns: id, tool_result, success, error

Company: Get

hubspot/company_get · Action

Retrieve a HubSpot company by its ID. Optionally request specific properties and associated object types.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Company ID	`string`	Required	12345
Properties	`string`		Comma-separated property names (optional)
Associations	`string`		Comma-separated object types, e.g. contacts,deals (optional)

Returns: id, properties, result, tool_result, success, error

Company: List

hubspot/company_list · Action

List HubSpot companies a page at a time. Pass the returned After cursor to fetch the next page.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Limit	`integer`		100 (max)
After (cursor)	`string`		Pagination cursor from a previous page
Properties	`string`		Comma-separated property names (optional)

Returns: results, count, after, result, tool_result, success, error

Company: Search

hubspot/company_search · Action

Search HubSpot companies by free text or a property filter (e.g. domain EQ acme.com). Returns matching companies.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Query	`string`		Free-text search (optional)
Filter Property	`string`		domain
Filter Operator	`string`		EQ — choices: Equals, Not equals, Greater than, Greater than or equal, Less than, Less than or equal, Contains token, Has property, Has no property
Filter Value	`string`		acme.com
Filter Groups (advanced)	`object`		Raw HubSpot filterGroups array; overrides the simple filter
Properties	`string`		Comma-separated property names to return (optional)
Limit	`integer`		100
After (cursor)	`string`		Pagination cursor from a previous page

Returns: results, count, after, result, tool_result, success, error

Company: Update

hubspot/company_update · Action

Update properties on an existing HubSpot company. Only the fields you set are changed.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Company ID	`string`	Required	12345
Name	`string`		Acme Inc
Domain	`string`		acme.com
Industry	`string`		COMPUTER_SOFTWARE
Phone	`string`		+1 555 0100
City	`string`		London
State/Region	`string`		England
Country	`string`		United Kingdom
Website	`string`		https://acme.com
Additional Properties	`key_value_array`		Any other company property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

04Contact

Contact: Create

hubspot/contact_create · Action

Create a new contact in HubSpot. Set common fields directly or add any other property via Additional Properties. Returns the contact ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Email	`string`		jane@example.com
First Name	`string`		Jane
Last Name	`string`		Doe
Phone	`string`		+1 555 0100
Company	`string`		Acme Inc
Job Title	`string`		Head of Sales
Website	`string`		https://example.com
Additional Properties	`key_value_array`		Any other contact property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

Contact: Delete

hubspot/contact_delete · Action

Archive (soft-delete) a HubSpot contact by its ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Contact ID	`string`	Required	12345

Returns: id, tool_result, success, error

Contact: Get

hubspot/contact_get · Action

Retrieve a HubSpot contact by its ID. Optionally request specific properties and associated object types.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Contact ID	`string`	Required	12345
Properties	`string`		Comma-separated property names (optional)
Associations	`string`		Comma-separated object types, e.g. companies,deals (optional)

Returns: id, properties, result, tool_result, success, error

Contact: List

hubspot/contact_list · Action

List HubSpot contacts a page at a time. Pass the returned After cursor to fetch the next page.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Limit	`integer`		100 (max)
After (cursor)	`string`		Pagination cursor from a previous page
Properties	`string`		Comma-separated property names (optional)

Returns: results, count, after, result, tool_result, success, error

Contact: Search

hubspot/contact_search · Action

Search HubSpot contacts by free text or a property filter (e.g. email EQ jane@example.com). Returns matching contacts.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Query	`string`		Free-text search (optional)
Filter Property	`string`		email
Filter Operator	`string`		EQ — choices: Equals, Not equals, Greater than, Greater than or equal, Less than, Less than or equal, Contains token, Has property, Has no property
Filter Value	`string`		jane@example.com
Filter Groups (advanced)	`object`		Raw HubSpot filterGroups array; overrides the simple filter
Properties	`string`		Comma-separated property names to return (optional)
Limit	`integer`		100
After (cursor)	`string`		Pagination cursor from a previous page

Returns: results, count, after, result, tool_result, success, error

Contact: Update

hubspot/contact_update · Action

Update properties on an existing HubSpot contact. Only the fields you set are changed.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Contact ID	`string`	Required	12345
Email	`string`		jane@example.com
First Name	`string`		Jane
Last Name	`string`		Doe
Phone	`string`		+1 555 0100
Company	`string`		Acme Inc
Job Title	`string`		Head of Sales
Website	`string`		https://example.com
Additional Properties	`key_value_array`		Any other contact property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

05Deal

Deal: Create

hubspot/deal_create · Action

Create a new deal in HubSpot. Set common fields directly or add any other property via Additional Properties. Returns the deal ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Deal Name	`string`		Acme - Q3 expansion
Amount	`string`		5000
Pipeline	`string`		default
Deal Stage	`string`		appointmentscheduled
Close Date	`string`		2026-09-30 or epoch ms
Owner ID	`string`		HubSpot owner ID (optional)
Additional Properties	`key_value_array`		Any other deal property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

Deal: Delete

hubspot/deal_delete · Action

Archive (soft-delete) a HubSpot deal by its ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Deal ID	`string`	Required	12345

Returns: id, tool_result, success, error

Deal: Get

hubspot/deal_get · Action

Retrieve a HubSpot deal by its ID. Optionally request specific properties and associated object types.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Deal ID	`string`	Required	12345
Properties	`string`		Comma-separated property names (optional)
Associations	`string`		Comma-separated object types, e.g. contacts,companies (optional)

Returns: id, properties, result, tool_result, success, error

Deal: List

hubspot/deal_list · Action

List HubSpot deals a page at a time. Pass the returned After cursor to fetch the next page.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Limit	`integer`		100 (max)
After (cursor)	`string`		Pagination cursor from a previous page
Properties	`string`		Comma-separated property names (optional)

Returns: results, count, after, result, tool_result, success, error

Deal: Search

hubspot/deal_search · Action

Search HubSpot deals by free text or a property filter (e.g. dealstage EQ closedwon). Returns matching deals.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Query	`string`		Free-text search (optional)
Filter Property	`string`		dealstage
Filter Operator	`string`		EQ — choices: Equals, Not equals, Greater than, Greater than or equal, Less than, Less than or equal, Contains token, Has property, Has no property
Filter Value	`string`		closedwon
Filter Groups (advanced)	`object`		Raw HubSpot filterGroups array; overrides the simple filter
Properties	`string`		Comma-separated property names to return (optional)
Limit	`integer`		100
After (cursor)	`string`		Pagination cursor from a previous page

Returns: results, count, after, result, tool_result, success, error

Deal: Update

hubspot/deal_update · Action

Update properties on an existing HubSpot deal. Only the fields you set are changed.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Deal ID	`string`	Required	12345
Deal Name	`string`		Acme - Q3 expansion
Amount	`string`		5000
Pipeline	`string`		default
Deal Stage	`string`		closedwon
Close Date	`string`		2026-09-30 or epoch ms
Owner ID	`string`		HubSpot owner ID (optional)
Additional Properties	`key_value_array`		Any other deal property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

06Disassociate

Association: Unlink Records

hubspot/disassociate · Action

Remove the association between two HubSpot records. Direction is from -> to.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
From Object Type	`string`	Required	contacts
From Record ID	`string`	Required	12345
To Object Type	`string`	Required	companies
To Record ID	`string`	Required	67890

Returns: tool_result, success, error

07List

List: Add Contacts

hubspot/list_add_contact · Action

Add contacts to a HubSpot static list by contact ID and/or email address. Only works on static (not dynamic) lists.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
List ID	`string`	Required	Static list ID
Contact IDs	`string`		Comma-separated contact IDs (vids)
Emails	`string`		Comma-separated email addresses

Returns: result, updated, tool_result, success, error

List: Remove Contacts

hubspot/list_remove_contact · Action

Remove contacts from a HubSpot static list by contact ID. Only works on static (not dynamic) lists.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
List ID	`string`	Required	Static list ID
Contact IDs	`string`	Required	Comma-separated contact IDs (vids)

Returns: result, updated, tool_result, success, error

08Ticket

Ticket: Create

hubspot/ticket_create · Action

Create a new support ticket in HubSpot. Set common fields directly or add any other property via Additional Properties. Returns the ticket ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Subject	`string`	Required	Cannot log in
Content	`text`		Description of the issue
Pipeline	`string`		Defaults to 0 (Support Pipeline)
Pipeline Stage	`string`		Defaults to 1 (New)
Priority	`string`		HIGH — choices: Low, Medium, High
Additional Properties	`key_value_array`		Any other ticket property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

Ticket: Delete

hubspot/ticket_delete · Action

Archive (soft-delete) a HubSpot ticket by its ID.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Ticket ID	`string`	Required	12345

Returns: id, tool_result, success, error

Ticket: Get

hubspot/ticket_get · Action

Retrieve a HubSpot ticket by its ID. Optionally request specific properties and associated object types.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Ticket ID	`string`	Required	12345
Properties	`string`		Comma-separated property names (optional)
Associations	`string`		Comma-separated object types, e.g. contacts,companies (optional)

Returns: id, properties, result, tool_result, success, error

Ticket: List

hubspot/ticket_list · Action

List HubSpot tickets a page at a time. Pass the returned After cursor to fetch the next page.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Limit	`integer`		100 (max)
After (cursor)	`string`		Pagination cursor from a previous page
Properties	`string`		Comma-separated property names (optional)

Returns: results, count, after, result, tool_result, success, error

Ticket: Search

hubspot/ticket_search · Action

Search HubSpot tickets by free text or a property filter (e.g. hs_ticket_priority EQ HIGH). Returns matching tickets.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Query	`string`		Free-text search (optional)
Filter Property	`string`		hs_ticket_priority
Filter Operator	`string`		EQ — choices: Equals, Not equals, Greater than, Greater than or equal, Less than, Less than or equal, Contains token, Has property, Has no property
Filter Value	`string`		HIGH
Filter Groups (advanced)	`object`		Raw HubSpot filterGroups array; overrides the simple filter
Properties	`string`		Comma-separated property names to return (optional)
Limit	`integer`		100
After (cursor)	`string`		Pagination cursor from a previous page

Returns: results, count, after, result, tool_result, success, error

Ticket: Update

hubspot/ticket_update · Action

Update properties on an existing HubSpot ticket. Only the fields you set are changed.

Field	Type		Details
HubSpot Private App Token	`secret`	Required	pat-...
Ticket ID	`string`	Required	12345
Subject	`string`		Cannot log in
Content	`text`		Description of the issue
Pipeline	`string`		0 (Support Pipeline)
Pipeline Stage	`string`		4 (Closed)
Priority	`string`		HIGH — choices: Low, Medium, High
Additional Properties	`key_value_array`		Any other ticket property (key = HubSpot internal name)

Returns: id, properties, result, tool_result, success, error

09Triggers

HubSpot Webhook Trigger

trigger/hubspot_webhook · Trigger

Triggers a flow when a HubSpot webhook event is received (contact/company/deal/ticket creation, deletion, or property change).

Field	Type		Details
App Secret	`secret`		Client secret for X-HubSpot-Signature validation
Event Filter	`string`		Comma-separated: contact.creation,deal.propertyChange,ticket.creation

Returns: content, event_type, object_id, property_name, property_value, change_source, portal_id, occurred_at, body, triggered_at

10Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

Deleting a contact, company, deal or ticket archives (soft-deletes) it rather than permanently removing it, and archived records can still be restored from within HubSpot for a limited window afterwards.
Search results are eventually consistent, so a record you just created or updated may take a few seconds to appear in the corresponding search action.
Search actions return at most the first 10,000 matching records across all pages, so use a specific property filter rather than relying on paging through very large result sets.
List add-contact and remove-contact only work on static lists; dynamic (active) lists manage their own membership and cannot be edited by these actions.
Associating records applies the default association type in the stated from -> to direction, so pick the record order deliberately when linking a contact, company, deal or ticket.
Any field beyond the common ones must be passed via Additional Properties using HubSpot's internal property name (for example hs_ticket_priority), not the label shown in the HubSpot UI.