Search Contacts
Searches 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.
Inputs
| Property | Field | Description |
|---|---|---|
| After | inAfter | Pagination cursor from previous response |
| Client ID | inClientID | Client ID from Connect node (optional if credentials provided) |
| Filters | inFilters | Array of filter objects [{propertyName، operator، value}] |
| Properties | inProperties | List of properties to return |
| Query | inQuery | Search query text |
Outputs
| Property | Field | Description |
|---|---|---|
| Contacts | outContacts | Array of matching contacts |
| Has More | outHasMore | Whether more results are available |
| Next Cursor | outAfter | Cursor for next page of results |
| Total | outTotal | Number of contacts returned |
Options
| Property | Field | Description |
|---|---|---|
| Credentials | optCredentials | HubSpot credentials (optional - use instead of Connect node) |
| Limit | optLimit | Maximum number of results (max 200) |
| Sort By | optSortProperty | Property to sort by One of: createdate, lastmodifieddate, firstname, lastname, email. |
| Sort Direction | optSortDirection | Sort order One of: ASCENDING, DESCENDING. |
Requirements
- 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 URLsclient_id— Client ID (text, required). OAuth2 Client ID from HubSpot Developer Accountclient_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.
Related nodes
Create Contact · Get Contact · Update Contact · Delete Contact · List Contacts
Elsewhere in the package: Connect · Disconnect · Create Company · Get Company · Update Company · Delete Company · List Companies · Search Companies · Create Deal · Get Deal and 12 more
See also
- HubSpot — every node in this package
- Message object — how properties read values from
msg - Handling failure — Continue On Error, Catch and retries