Aggregate Contacts

Aggregate contacts by group-by fields — ideal for dashboards, charts, and analytics.

Use this endpoint to generate counts, sums, averages, min/max grouped by one or more contact fields. Perfect for building distribution charts, conversion funnels, or source-performance reports.

Request Body (AggregateRequest): Same as leads/aggregate.

Examples:

• Contacts by status: {"group_by_fields": ["status"]}
• Contacts by marketing source: {"group_by_fields": ["marketing_source"]}
• Contacts by source + status: {"group_by_fields": ["marketing_source", "status"]}