Facebook Leads
Manage and retrieve leads from Facebook lead generation forms
Tools
| Name | Description |
|---|---|
list_formsList lead generation forms for a Facebook page | List lead generation forms for a Facebook page |
get_leadsGet leads from a lead generation form | Get leads from a lead generation form |
get_lead_detailGet detailed information for a specific lead | Get detailed information for a specific lead |
custom_api_callMake a custom API call to the Facebook Graph API | Make a custom API call to the Facebook Graph API |
Triggers
| Name | Description |
|---|---|
new_leadTriggers when a new lead is submitted through a lead generation form | Triggers when a new lead is submitted through a lead generation form |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('facebook-leads', 'list_forms', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'facebook-leads',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Facebook Leads to my app?
Use Weavz Hosted Connect for OAuth2 authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Facebook Leads support?
Facebook Leads supports 4 tools including List Lead Forms, Get Leads, Get Lead Detail, Custom API Call.
Can I use Facebook Leads with AI agents?
Yes. Add Facebook Leads to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Facebook Leads to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Facebook Leads as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Facebook Leads tools exposed by that workspace.
Does Facebook Leads work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Facebook Leads work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Facebook Leads?
Facebook Leads exposes 4 tools, including List Lead Forms, Get Leads, Get Lead Detail, Custom API Call. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Facebook Leads be used in stateful agent workflows?
Yes. Agents can combine Facebook Leads tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Facebook Leads use?
Facebook Leads uses OAuth2. Weavz stores OAuth credentials securely and refreshes tokens when supported by the provider.
How much does the Facebook Leads integration cost?
The Facebook Leads integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Facebook Leads support?
Facebook Leads supports 1 triggers including New Lead.
Connect Facebook Leads in minutes
Get 20,000 free action executions every month. No credit card required.