Hyros icon

Hyros

Interact with Hyros API - Complete coverage of all endpoints

Actions60

Lead → Count By Attribute

AI-generated

Summary

Counts leads grouped by a selected attribute using the Hyros lead aggregation endpoint. Apply optional lead filters and set a maximum number of groups to return.

Inputs

  • Attribute (required) — Group by First Source Tag, Last Source Tag, Stage, or Tag (default). A lead with no value for the chosen attribute is not included in a group; leads with multiple values can appear in multiple groups.
  • Groups Limit — Maximum number of groups to return, from 1 to 1,000; defaults to 250. Groups are returned largest first.
  • Filters — Optionally filter by comma-separated emails, lead IDs, phone numbers, stages, or tags (up to 50 values per list); join-date range; tag-assignment date range; or last-updated date range. Tag date filters require recorded tag-assignment dates. Updated date filters can capture leads re-tagged or re-staged after joining.

Output shape

A single object per input item, containing groups, remainingCount, and totalCount.

Groups beyond the limit are omitted; remainingCount reports how many records were left out. Do not sum group counts to get the total, because leads can have multiple attribute values or no value; use totalCount.

Links

Discussion