List submitted leads
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.
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. LinkedIn ads accounts switch to the live fetch.
LinkedIn only: the LinkedIn ad account id whose responses to read (owner-scoped finder).
251 <= value <= 100Unix seconds; only leads created at/after this timestamp.
Keyset cursor from a previous response's pagination.cursor (Meta: AdLead id; LinkedIn: numeric start offset).
Response 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.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": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}{
"error": "Unauthorized"
}List lead forms GET
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.
Create a lead form POST
Creates a Lead Gen form. The form content goes inside `platformSpecificData` for both platforms (the shape is selected by the accountId's platform). Meta: created on the connected Facebook Page (POST /{page-id}/leadgen_forms); the old top-level Meta fields (questions, thankYou*, contextCard, …) are DEPRECATED but still accepted while platformSpecificData is absent — mixing both shapes is a 400. LinkedIn: created on the ad account's Company Page. NOT idempotent — a retry creates a second form. Meta prefilled question types (EMAIL, PHONE, FULL_NAME, …) must omit label/key; CUSTOM questions require both. LinkedIn exposes only free-text and multiple-choice questions via API (prefilled-from-profile fields are Campaign Manager UI-only). Requires the Ads add-on.