API Reference

Meta Ads / API Reference

meta_ads_create_lead_form_and_paused_ad

Complete lead-gen workflow: create lead form, creative, and PAUSED ad. Requires account_id, page_id, adset_id, privacy_policy_url, message, and headline. questions may be a JSON string or JSON array.

This is a write tool: it creates lead form and paused ad 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 lead form and paused ad in my Meta Ads account for [page id], [adset id], [form name].

It takes 9 required and 11 optional parameters.

Parameters

ParameterTypeRequiredDescription
account_idstringYesAccount Id
page_idstringYesPage Id
adset_idstringYesAdset Id
form_namestringYesForm Name
privacy_policy_urlstringYesPrivacy Policy Url
creative_namestringYesCreative Name
ad_namestringYesAd Name
messagestringYesMessage
headlinestringYesHeadline
standard_fields_csvstringNoStandard Fields Csv
questionsanyNoQuestions
thank_you_messagestringNoThank You Message
localestringNoLocale
follow_up_action_urlstringNoFollow Up Action Url
image_hashstringNoImage Hash
image_urlstringNoImage Url
link_urlstringNoLink Url
page_access_tokenstringNoPage Access Token
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