Leads read
leads_readCounts the leads of a Meta campaign, ad set, ad or instant form (scope and its Meta id) from since to until, in the ad account's days: the total, by day, by form, by ad set and by ad, with the address of the Leads tab. The leads themselves (when each came, every answer, the form and the ad) are a CSV at file, signed for the connected person, valid for one hour and opened once signed in to Adrails. The result holds no name, email, phone or answer: Meta is asked for each lead's id, time and ad alone. A connection without the leads permissions, or a Page the business connection did not grant, returns the Leads tab's sentence saying what grants it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"input": "<input>"
},
"name": "leads_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | ||
| accountIds | No | Optional account selection; can only narrow this workspace's access. | |
| userStatement | No | Required for launch_brief: the user's request or answer for this launch, in their own words. Otherwise optional: the user's request for this call, treated as an unverified user statement, never permission or verified platform evidence. | |
| idempotencyKey | No | Required for mutations. Reuse the same key only when retrying the exact same call; a completed outcome is applied once. |