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 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
GET
/v1/ads/lead-forms/{formId}/leads

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

formId*string

Query Parameters

accountId*string
limit?integer
Range1 <= value <= 100
Default25
cursor?string
since?integer

Unix seconds.

Response Body

application/json

application/json

application/json

{  "status": "string",  "leads": [    {      "id": "string",      "createdTime": "string",      "adId": "string",      "formId": "string",      "fields": {        "property1": "string",        "property2": "string"      },      "fieldData": [        {}      ]    }  ],  "pagination": {    "hasMore": true,    "cursor": "string"  }}
Was this page helpful?

Reserve a Reach & Frequency prediction

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

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.