lead gen
List leads for a single form
Returns leads for one form. Serves persisted leads (ingested via the leadgen webhook) when available, falling back to a live Graph read.
PlatformsMeta
AuthorizationBearer <token>
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
formIdstring
Query Parameters
accountIdstring
limit?integer
Default
25Range
1 <= value <= 100cursor?string
since?integer
Unix seconds.
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.leadgen.listFormLeads({ path: { formId: 'form_abc123', }, query: { accountId: 'account_abc123', },});console.log(data);{
"status": "success",
"leads": [
{
"id": "string",
"createdTime": "string",
"adId": "string",
"formId": "string",
"fields": {
"property1": "string",
"property2": "string"
},
"fieldData": [
{}
]
}
],
"pagination": {
"hasMore": true,
"cursor": "string"
}
}{
"error": "Unauthorized"
}Reserve a Reach & Frequency prediction POST
Locks the quoted price + inventory until the returned `expiresAt` and mints a NEW prediction id — pass that RESERVED id (not the original) as `rfPredictionId` on POST /v1/ads/create. Release an unused reservation via DELETE.
List lead forms GET
Lists the Lead Gen forms owned by the connected Facebook Page. Requires the Ads add-on.