meta_ads_lead_forms_create
Create a Facebook lead form for Meta Ads. Add custom questions to capture lead data. Privacy policy URL required. Returns new form ID.
Instructions
Creates a new lead form on a Facebook Page. Returns the new form_id. Mutating, reversible via rollback_apply (rollback archives the form rather than deleting submitted leads). Questions is an ordered list of standard Meta types (FULL_NAME, EMAIL, PHONE_NUMBER, COMPANY_NAME, JOB_TITLE, CITY, STATE, ZIP_CODE, COUNTRY, DATE_OF_BIRTH) or CUSTOM (requires key, label, and options for dropdowns). Meta requires a privacy_policy_url by policy.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_id | No | Meta Ads account ID in the format 'act_XXXXXXXXXX' (e.g. 'act_1234567890'). Optional — falls back to META_ADS_ACCOUNT_ID from the configured credentials. The leading 'act_' prefix is required. | |
| page_id | Yes | Facebook Page ID that will own the form. | |
| name | Yes | Form name shown in Ads Manager and Page Lead Center. | |
| questions | Yes | Ordered question list. Standard-type questions only need `type`; CUSTOM questions require `key`, `label`, and (for dropdowns) `options`. | |
| privacy_policy_url | Yes | HTTPS URL of the advertiser's privacy policy. Required by Meta policy — forms without one are rejected. | |
| follow_up_action_url | No | Optional URL the user is redirected to after submission (e.g. thank-you page). Omit to show Meta's default confirmation only. Superseded by thank_you_page when both are supplied. | |
| locale | No | Optional form locale (e.g. ``ja_JP``). Defaults to the Page's primary locale. | |
| context_card | No | Optional intro / welcome screen shown before the form. Lifts conversion rate measurably when supplied. Expected keys: title, content, style (PARAGRAPH_STYLE or LIST_STYLE), cover_photo_id. | |
| thank_you_page | No | Optional custom completion screen with a CTA. Replaces follow_up_action_url's simple redirect when supplied. Expected keys: title, body, button_type (VIEW_WEBSITE / CALL_BUSINESS / MESSAGE_BUSINESS / DOWNLOAD / DOWNLOAD_APP), website_url, button_text. | |
| is_higher_intent | No | When true, Meta renders a 3-step form (input → review → submit) which trims junk submissions at the cost of total leads volume. Default false (single-step). | |
| conditional_questions_choices | No | Branching logic — given a prior question's value, choose which question to ask next. Each entry: {question: <key>, value: <choice>, next_question_key: <key>}. Meta validates the keys refer to real questions. |