List leads
crm_list_leadsRead-onlyIdempotent
Leads in this workspace, newest activity first. Phone and email are MASKED here — use crm_get_lead for one record when the full contact is genuinely needed. total is the count before paging, so it answers 'how many leads exist'. [scope: crm:read]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of rows to return. | |
| since | No | today | yesterday | week | month | 7d | 30d | ISO timestamp. Days are Asia/Dubai. | |
| stage | No | Stage name, exact (case-insensitive). Omit for all stages. | |
| offset | No | Rows to skip before the first returned row (for paging). | |
| pipeline_id | No | UUID of one pipeline. Omit for all. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | False when the call was refused or failed; see error. | |
| error | No | Machine-readable refusal code (a string), present only when ok is false. | |
| message | No | Human-readable explanation of a refusal (a string). |