leads_list
List leads with pagination and filtering by owner, person, or organization. Use start/limit for pagination and optional date or filter ID restrictions.
Instructions
List leads with pagination and filtering options.
Returns a paginated list of non-archived leads. Use filters to narrow results by owner, person, or organization.
Workflow tips:
Leads are sorted by creation time (oldest to newest)
Use owner_id to filter by lead owner
Use person_id or organization_id to filter by associated entities
filter_id takes precedence over other filters
Use start/limit for pagination (default limit: 100, max: 500)
For all leads without pagination, use leads/list_all_auto instead
Use add_time_from / add_time_until to filter by creation date (client-side). NOTE: this only filters the current page; for complete date-range results use leads/list_all_auto
Leads inherit custom fields structure from deals
Common use cases:
List all leads: {}
List leads for a specific owner: { "owner_id": 123 }
List leads for a person: { "person_id": 456 }
List leads for an organization: { "organization_id": 789 }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Field names and sorting mode (e.g., "title ASC, value DESC") | |
| limit | No | Number of items to return | |
| start | No | Pagination start | |
| owner_id | No | Filter by owner (user) ID | |
| filter_id | No | ID of the filter to use | |
| person_id | No | Filter by person ID | |
| add_time_from | No | Filter leads created on or after this date (YYYY-MM-DD). Applied client-side. | |
| add_time_until | No | Filter leads created on or before this date (YYYY-MM-DD). Applied client-side. | |
| organization_id | No | Filter by organization ID |