List lead forms
Lists the Lead Gen forms owned by the connected Facebook Page. Requires the Ads add-on.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Connected facebook account id.
251 <= value <= 100Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.listLeadForms({ query: { accountId: 'account_abc123', },});console.log(data);{
"status": "success",
"forms": [
{}
],
"pagination": {
"hasMore": true,
"cursor": "string"
}
}{
"error": "Unauthorized"
}Add users to audience POST
Upload user data to a customer_list audience. Data is SHA256-hashed server-side before sending to the platform. Email is used on every platform; phone is used on Meta only (other platforms ignore it). On TikTok and Pinterest, the first upload also provisions the audience (deferred create). LinkedIn uploads are full-replace. Max 10,000 users per request.
Create a lead form POST
Creates a Lead Gen form on the connected Facebook Page (POST /{page-id}/leadgen_forms). NOT idempotent — a retry creates a second form. Prefilled question types (EMAIL, PHONE, FULL_NAME, …) must omit label/key; CUSTOM questions require both. Requires the Ads add-on.