Create Meta Lead Form

Creates 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) in Meta's full form (EN_US, EN_GB, DE_DE, AR_AR…); it sets BOTH Meta's own interface strings AND the three texts this tool supplies (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. 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=<returned id>) on an ad set whose optimization_goal is LEAD_GENERATION and whose promoted_object page_id is this Page. confirm=false = preview.