List leads
list_leadsRetrieve contacts by tag or free-text search with cursor pagination. Filter leads by name or phone number to locate target records efficiently.
Instructions
List leads (contacts). Filter by tag or free-text search. Cursor-paginated.
Requires scope leads:read.
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": "list_leads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | ||
| limit | No | Page size, 1–100. Default 20. | |
| search | No | Matches name or phone number. | |
| ending_before | No | Cursor from a previous response. Fetches the page before it. Not with starting_after. | |
| starting_after | No | Cursor from a previous response's next_cursor. Fetches the page after it. |