Zernio
Zernio
API Reference

Lead Gen

List leads for a single formGETList lead formsGETList submitted leadsGETCreate a lead formPOSTCreate a test leadPOSTGet a lead formGETArchive a lead formDELETE
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Lead Gen

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.

PlatformsMetaLinkedIn
GET
/v1/ads/leads

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

formId?string

Filter to a single lead form.

accountId?string

Filter to a single connected account. LinkedIn ads accounts switch to the live fetch.

adAccountId?string

LinkedIn only: the LinkedIn ad account id whose responses to read (owner-scoped finder).

limit?integer
Range1 <= value <= 100
Default25
since?integer

Unix seconds; only leads created at/after this timestamp.

cursor?string

Keyset cursor from a previous response's pagination.cursor (Meta: AdLead id; LinkedIn: numeric start offset).

Response Body

application/json

application/json

application/json

{  "status": "string",  "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"  }}
Was this page helpful?

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.

Create a lead form

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.