HubSpot: Search Contacts

Plugin ID: eca_hubspot_search_contacts

Available since: 1.0.0

Find contacts by property criteria and filters.

Fields

Search Filters (YAML) — config key: filters

Search filters in YAML format. Each filter should specify propertyName, operator, and value. Common operators: EQ (equals), NEQ (not equals), LT/LTE/GT/GTE (comparisons), CONTAINS_TOKEN (partial match with wildcards), HAS_PROPERTY, NOT_HAS_PROPERTY, IN, NOT_IN. See HubSpot Search API documentation for full list.

Example using inline format (recommended - no indentation required):
- {propertyName: "lifecyclestage", operator: "EQ", value: "lead"}<br>- {propertyName: "email", operator: "CONTAINS_TOKEN", value: "*@example.com"}

Alternative block format (requires 2-space indentation):
- propertyName: "lifecyclestage"<br>&nbsp;&nbsp;operator: "EQ"<br>&nbsp;&nbsp;value: "lead"
This field supports tokens.

Type: textarea · Required: no · Default: empty string

Sort By — config key: sort_by

Property name to sort results by (e.g., "createdate"). Leave empty for default sorting.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

Limit — config key: limit

Maximum number of results to return (1-100). Default is 100.
This field supports tokens.

Type: textfield · Required: yes · Default: 100

Token name — config key: token_name

Provide the name of a token that holds the search results array including total count and matching contacts.
This field supports tokens.

Type: textfield · Required: no · Default: empty string