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 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.

PlatformsMetaLinkedIn
GET
/v1/ads/lead-forms

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

accountId*string

Connected facebook or linkedin ads account id.

adAccountId?string

LinkedIn only: the LinkedIn ad account id (used to resolve the owning organization). Required for LinkedIn.

limit?integer
Range1 <= value <= 100
Default25
cursor?string

Response Body

application/json

application/json

application/json

{  "status": "string",  "forms": [    {}  ],  "pagination": {    "hasMore": true,    "cursor": "string"  }}
Was this page helpful?

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.

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.