API Reference

Meta Ads / API Reference

meta_ads_create_leadgen_form

Meta Ads tool. Create a Facebook Lead Gen form on a Page. Args: page_id: Facebook Page ID or connected Page name. Use meta_ads_find_page if unsure. name: Internal name for the form. privacy_policy_url: URL to your privacy policy (required by Meta). questions: Optional JSON array of question objects. Each has 'type' (built-in: FULL_NAME, EMAIL, PHONE, CITY, COMPANY_NAME, JOB_TITLE, etc.) or for custom questions: {"type":"CUSTOM","label":"Your question","key":"custom_key"}. Example: '[{"type":"FULL_NAME"},{"type":"EMAIL"},{"type":"PHONE"}]' page_access_token: Optional Page-level access token. Leave blank to auto-discover from connected Meta Pages. thank_you_message: Message shown after submission. Defaults to generic. locale: Form locale, e.g. en_US, he_IL. follow_up_action_url: URL to redirect after form submit. context_card_title: Optional intro card title shown before the form. context_card_content: Optional intro card body text. standard_fields_csv: Built-in fields to use when questions is blank. Default FULL_NAME,EMAIL,PHONE. privacy_policy_link_text: Link text for the privacy policy. thank_you_button_type: Thank-you CTA type. Default VIEW_WEBSITE. thank_you_button_text: Thank-you CTA button text. Default Visit Website.

This is a write tool: it creates leadgen form in your Meta Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Create leadgen form in my Meta Ads account for [page id], [name], [privacy policy url].

It takes 3 required and 11 optional parameters.

Parameters

ParameterTypeRequiredDescription
page_idstringYesPage Id
namestringYesName
privacy_policy_urlstringYesPrivacy Policy Url
questionsstringNoQuestions
page_access_tokenstringNoPage Access Token
thank_you_messagestringNoThank You Message
localestringNoLocale
follow_up_action_urlstringNoFollow Up Action Url
context_card_titlestringNoContext Card Title
context_card_contentstringNoContext Card Content
standard_fields_csvstringNoStandard Fields Csv
privacy_policy_link_textstringNoPrivacy Policy Link Text
thank_you_button_typestringNoThank You Button Type
thank_you_button_textstringNoThank You Button Text

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads