SearchRequest

Request body for searching contacts or companies with filters, sorting, and pagination. Follows HubSpot CRM API v3 structure for familiar integration patterns.

  • Groups of filters combined with OR logic. Within each group, filters are combined with AND logic. Maximum 5 filter groups allowed (following HubSpot limits).

    Properties: 1
  • Maximum number of results to return per page. Range: 1-100. Defaults to 100.

  • Number of results to skip (for pagination). Maximum offset: 10,000 (following HubSpot search limit).

  • Optional free-text query using field:value syntax (e.g., "email:@acme.com tag:vip"). Supported fields depend on entity type. Translated into filterGroups server-side and combined with any explicitly provided filterGroups using AND logic (results must match both the query and the explicit filters).

  • Fields to sort results by, applied in order. Maximum 3 sort fields allowed to prevent query complexity.

    Properties: 2