List Meta Lead Forms
User wants to see their Meta lead generation forms, list lead forms, or find a lead form ID.
Lists all lead generation forms for a Facebook Page associated with the ad account.
When to use this tool:
- “Show me my Meta lead forms”
- “List my Facebook lead generation forms”
- “What lead forms do I have?”
- “Find my lead form ID”
- “Show lead forms for my page”
Returns per form:
- Form name, status (ACTIVE/ARCHIVED), leads count
- Creation date
- Form questions (field names and types)
- Form ID (needed for get_meta_lead_form_submissions and campaign creation with lead_form_id)
Parameters:
- page_id: Facebook Page ID (optional — auto-resolved from ad account if not provided)
- ad_account_id: Required for multi-account users. Get from list_connected_accounts
- limit: Maximum forms to return (default: 50)
Note: Lead forms belong to Facebook Pages, not ad accounts. If you don’t have the page_id, just omit it and the tool will auto-resolve from the ad account’s promotable pages.
Permission: Requires ‘leads_retrieval’ scope. If the user gets a permission error, they need to disconnect and reconnect their Meta account to grant the updated permissions.
Execution time: 2-5 seconds Data source: Meta Marketing API (live)
Authorizations
API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.
Headers
Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000
Body
All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.
Input schema for listing Meta lead generation forms.
Response
Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).
Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.