Create a lead form

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.

Authorization

AuthorizationBearer <token>

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

In: header

Request Body

accountIdstring

namestring

Lengthlength <= 200

questions

Items1 <= items

privacyPolicyUrlstring

Formaturi

privacyPolicyLinkText?string

Lengthlength <= 70

followUpActionUrl?string

Formaturi

locale?string

thankYouTitle?string

thankYouBody?string

thankYouButtonText?string

thankYouButtonType?string

thankYouWebsiteUrl?string

Formaturi

isOptimizedForQuality?boolean

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.createLeadForm({  body: {    accountId: 'account_abc123',    name: 'Example',    questions: [      {        type: 'string',      },    ],    privacyPolicyUrl: 'https://example.com',  },});console.log(data);

{
  "status": "success",
  "form": {
    "id": "string",
    "name": "string"
  }
}

{
  "error": "Unauthorized"
}

Empty

Authorization

AuthorizationBearer <token>

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

In: header

Request Body

accountIdstring

namestring

Lengthlength <= 200

questions

Items1 <= items

privacyPolicyUrlstring

Formaturi

privacyPolicyLinkText?string

Lengthlength <= 70

followUpActionUrl?string

Formaturi

locale?string

thankYouTitle?string

thankYouBody?string

thankYouButtonText?string

thankYouButtonType?string

thankYouWebsiteUrl?string

Formaturi

isOptimizedForQuality?boolean

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.ads.createLeadForm({
  body: {
    accountId: 'account_abc123',
    name: 'Example',
    questions: [
      {
        type: 'string',
      },
    ],
    privacyPolicyUrl: 'https://example.com',
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.createLeadForm({  body: {    accountId: 'account_abc123',    name: 'Example',    questions: [      {        type: 'string',      },    ],    privacyPolicyUrl: 'https://example.com',  },});console.log(data);

{
  "status": "success",
  "form": {
    "id": "string",
    "name": "string"
  }
}

{
  "error": "Unauthorized"
}

Empty

Create a lead form

Authorization

Request Body

Response Body

200application/json

401application/json

403

Create a lead form

Authorization

Request Body

Response Body

200application/json

401application/json

403

application/json

application/json

application/json

application/json