Workflow blocks
Search Contacts
Search HubSpot contacts
hubspot/search-contacts — Search HubSpot contacts.
Where it appears
The Search Contacts block lives in the Integrations group of the Workflow Builder. Connect the Hubspot integration before adding it.
Fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
searchJson | code | Yes | — | HubSpot CRM Search API request body as JSON, using filterGroups with propertyName, operator, and value to filter contacts. |
Inputs and outputs
Inputs are the configurable fields above. The block produces these outputs:
Outputs
Reference an output downstream with <Search Contacts.field>.
| Name | Type | Description |
|---|---|---|
success | boolean | Operation succeeded |
results | json | Search results |
error | string | Error message if failed |
Example
A minimal configuration for this block:
{
"type": "hubspot/search-contacts",
"config": {
"searchJson": "..."
}
}Limits and failure modes
- Requires a connected Hubspot integration. Calls fail if that integration is disconnected or its authorization has expired.
- Required field (
searchJson) must be set, or the block fails validation before it runs. - On failure the
erroroutput is populated; downstream blocks that reference other outputs may not receive values.