leads_summary
Aggregate CRM leads server-side into totals, won/lost/open counts, and breakdowns by pipeline, status, owner, loss reason, month, tag, or custom field, with filters for funnel and source reports.
Instructions
Aggregate leads server-side without returning them: totals, won/lost/open, and breakdowns by pipeline, status, responsible user, loss reason, month, tag, or a custom field. Accepts the same filters as list_leads. Use for funnel snapshots, loss-reason and source reports.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "leads_summary"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group_by | No | Dimensions to break the count down by (default: pipeline + status). Each dimension is reported separately. | |
| statuses | No | Filter by statuses: array of {pipeline_id, status_id} | |
| closed_to | No | Closed at or before this date | |
| max_pages | No | Safety cap on pages of 250 leads (default 40 = 10,000 leads) | |
| created_to | No | Created at or before this date | |
| updated_to | No | Updated at or before this date | |
| closed_from | No | Closed at or after this date | |
| pipeline_id | No | Filter by pipeline ID | |
| created_from | No | Created at or after this date | |
| updated_from | No | Updated at or after this date | |
| custom_field_id | No | Custom field ID for group_by=custom_field (see list_custom_fields) | |
| responsible_user_ids | No | Filter by responsible user IDs |