List Contacts

Lists contacts in HubSpot.

This node is also exposed as an AI Agent tool.

This node has 1 input port and 1 output port.

Common Properties

Every node shares these.

Name — the node's display name on the canvas.
Color — the node's colour on the canvas.
Delay Before (sec) — wait this long before the node runs.
Delay After (sec) — wait this long after the node runs.
Continue On Error — carry on instead of failing the flow. Defaults to false.

info

When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.

Property	Field	Description
After	`inAfter`	Pagination cursor from previous response
Client ID	`inClientID`	Client ID from Connect node (optional if credentials provided)
Properties	`inProperties`	List of properties to return (comma-separated string or array)

Property	Field	Description
Contacts	`outContacts`	Array of contact objects
Has More	`outHasMore`	Whether more contacts are available
Next Cursor	`outAfter`	Cursor for next page of results
Total	`outTotal`	Total number of contacts returned

Property	Field	Description
Credentials	`optCredentials`	HubSpot credentials (optional - use instead of Connect node)
Limit	`optLimit`	Maximum number of contacts to return (max 100)

A Client ID from this package's Connect node, unless you set credentials directly on this node.
Private App Access Token — Access token from a HubSpot Private App
- value — Access Token (password, required). Private App access token from HubSpot
OAuth2 — OAuth2 authorization for user-level access
- _redirect_url — Redirect URL (readonly, optional). Add this to your HubSpot app's Redirect URLs
- client_id — Client ID (text, required). OAuth2 Client ID from HubSpot Developer Account
- client_secret — Client Secret (password, required). OAuth2 Client Secret

Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.