Create Meta Lead Form
create_meta_lead_formCreates an INSTANT FORM (lead form) on a Facebook Page, with custom questions, and returns the form id to attach to a lead ad. questions: each entry is EITHER a standard field Meta pre-fills from the user's profile — FULL_NAME, FIRST_NAME, LAST_NAME, EMAIL, PHONE, CITY, COMPANY_NAME, JOB_TITLE, DOB, GENDER … — OR a custom question written as 'Question text?|Option 1|Option 2' (with options it renders as a choice list, without options it is a free-text answer). privacy_policy_url is REQUIRED by Meta on every form. Optional: intro_headline / intro_description (the card shown before the questions), thank_you_text, follow_up_url (where the thank-you button goes). locale is the form's language (default TR) — give it in Meta's full form, e.g. EN_US, EN_GB, DE_DE, AR_AR; it sets BOTH Meta's own interface strings AND the three texts this tool supplies for you (the privacy-policy link text and the intro-card / thank-you buttons), so an EN_US form reads "Privacy Policy" / "Continue" / "Go to site". confirm=false shows those three under form_button_texts, so you can check the language before the form exists. higher_intent=true creates a 'Higher intent' Instant Form (Meta's is_optimized_for_quality — it adds a review/confirm step before submission, giving fewer but more qualified leads); the default is 'More volume'. Meta does NOT allow the form type to change after the form is published, so choose it at creation, and note Meta's API cannot create a form as an unpublished draft — use confirm=false to preview the fields (and see form_type) before it exists. After creating it, build the ad with create_meta_link_ad(..., lead_gen_form_id=) on an ad set whose optimization_goal is LEAD_GENERATION and whose promoted_object page_id is this Page. confirm=false = preview.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| locale | No | TR | |
| confirm | No | ||
| page_id | Yes | ||
| questions | Yes | ||
| follow_up_url | No | ||
| higher_intent | No | ||
| intro_headline | No | ||
| thank_you_text | No | ||
| intro_description | No | ||
| privacy_policy_url | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||