List submitted leads (cross-form CRM view)
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 Lead Gen (Instant) forms GET
Lists the Lead Gen forms owned by the connected Facebook Page. Requires the Ads add-on.
Search targeting interests (deprecated) GET
Deprecated alias for `GET /v1/ads/targeting/search?dimension=interest`. Kept for backward compatibility, it returns the legacy `{ interests: [...] }` shape rather than the normalized `{ results: [...] }`. New integrations should use `GET /v1/ads/targeting/search` with `dimension=interest`.