List lead forms
Lists the Lead Gen forms owned by the account. Meta: forms on the connected Facebook Page. LinkedIn: forms owned by the ad account's Company Page — pass adAccountId (LinkedIn forms are org-owned). Requires the Ads add-on.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Connected facebook or linkedin ads account id.
LinkedIn only: the LinkedIn ad account id (used to resolve the owning organization). Required for LinkedIn.
251 <= value <= 100Response Body
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.leadgen.listLeadForms({ query: { accountId: 'account_abc123', },});console.log(data);{
"status": "success",
"forms": [
{}
],
"pagination": {
"hasMore": true,
"cursor": "string"
}
}{
"error": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}{
"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.
List submitted leads GET
Returns submitted Lead Gen leads for your team, newest-first, with keyset pagination on `cursor`. For Meta (default) leads are served from the persisted cache, ingested in real time from the `leadgen` webhook. When `accountId` is a LinkedIn ads account, leads are fetched live from LinkedIn's `leadFormResponses` (LinkedIn has no webhook and enforces 90-day retention, so nothing is persisted) and `adAccountId` is required. Reading LinkedIn responses needs the `r_marketing_leadgen_automation` permission; accounts connected before it was added must reconnect. Requires the Ads add-on.