leads_list
List leads with pagination and filtering by owner, person, organization, or custom filter. Sorted by creation time.
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
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 |
|---|---|---|---|
| owner_id | No | Filter by owner (user) ID | |
| person_id | No | Filter by person ID | |
| organization_id | No | Filter by organization ID | |
| filter_id | No | ID of the filter to use | |
| sort | No | Field names and sorting mode (e.g., "title ASC, value DESC") | |
| start | No | Pagination start | |
| limit | No | Number of items to return |