Workflow blocks
Get Contacts
List HubSpot contacts (or fetch one by ID/email)
hubspot/get-contacts — List HubSpot contacts (or fetch one by ID/email).
Where it appears
The Get Contacts block lives in the Integrations group of the Workflow Builder. Connect the Hubspot integration before adding it.
Fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
contactIdOrEmail | text (supports references) | No | — | Optional HubSpot contact ID or email address to fetch a single contact. Leave empty to list contacts. Accepts literal text or <StepName.field>. |
limit | number | No | 100 | Maximum number of records to return when listing. Defaults to 100. |
Inputs and outputs
Inputs are the configurable fields above. The block produces these outputs:
Outputs
Reference an output downstream with <Get Contacts.field>.
| Name | Type | Description |
|---|---|---|
success | boolean | Operation succeeded |
result | json | Contacts data |
error | string | Error message if failed |
Example
A minimal configuration for this block:
{
"type": "hubspot/get-contacts",
"config": {
"limit": 100
}
}Limits and failure modes
- Requires a connected Hubspot integration. Calls fail if that integration is disconnected or its authorization has expired.
- On failure the
erroroutput is populated; downstream blocks that reference other outputs may not receive values.