List submitted leads
Returns persisted Meta Lead Gen leads for your team, newest-first, with keyset pagination on cursor. Leads are ingested in real time from the leadgen webhook. Requires the Ads add-on.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Filter to a single lead form.
Filter to a single connected account.
251 <= value <= 100Unix seconds; only leads created at/after this Meta timestamp.
Keyset cursor from a previous response's pagination.cursor.
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.listLeads();console.log(data);{
"status": "success",
"leads": [
{
"id": "string",
"leadgenId": "string",
"formId": "string",
"formName": "string",
"accountId": "string",
"adId": "string",
"adsetId": "string",
"campaignId": "string",
"isOrganic": true,
"createdTime": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"fieldData": [
{}
]
}
],
"pagination": {
"hasMore": true,
"cursor": "string"
}
}{
"error": "Unauthorized"
}List leads for a single form GET
Returns leads for one form. Serves persisted leads (ingested via the leadgen webhook) when available, falling back to a live Graph read.
Create a test lead POST
Submits a test lead against the form (POST /{form-id}/test_leads) to exercise retrieval without waiting for real ad impressions. Meta allows one test lead per form at a time.