List leads
list_leadsList the people who signed up through the workspace's lead magnets, newest first, 50 at a time: email, name, which lead magnet, when, where they came from (source, utm values, referrer) and what they did (pages read, downloads, shares). Filter by lead magnet, period, source or a search. This is personal data: use it only for what the user asks, and do not copy lists of leads anywhere else unless they ask. Needs the leads:read permission, which a person grants only by ticking it when connecting. Leads over the plan's monthly allowance are locked: counted but not listed, until the account moves up to Growth.
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 |
|---|---|---|---|
| order | No | Newest first (default) or oldest first. | desc |
| cursor | No | nextCursor from the previous page. | |
| period | No | This calendar month (UTC), the last 30 or 90 days, or all time (default). | all |
| search | No | Part of an email address or name. | |
| source | No | Only leads from this source key: a utm_source, a referring host, 'library' or 'direct'. | |
| magnetId | No | Only leads from this lead magnet (list_lead_magnets gives ids). |