Facebook Lead Ads

Facebook Lead Ads (part of the Meta Marketing API) lets advertisers create instant lead-generation forms on Facebook and Instagram and programmatically retrieve the leads captured through those forms. Through the Meta Graph API developers can list lead generation forms on a Page, read submitted leads, download bulk lead exports, and subscribe to webhooks for real-time lead delivery. Authentication uses Page access tokens issued via Facebook Login / Meta Business Login with the leads_retrieval, pages_show_list, and pages_manage_ads permissions.

Facebook Lead Ads publishes 6 APIs on the APIs.io network, including Bulk Leads API, Leadgen Forms API, Leads API, and 3 more. Tagged areas include Advertising, Lead Generation, Lead Ads, Marketing API, and Facebook.

The Facebook Lead Ads catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Facebook Lead Ads’ developer surface includes authentication, documentation, signup flow, support, changelog, sandbox, CLI, and 33 more developer resources.

🌐 Visit website 📡 Source on GitHub

56.3/100 strong ▬ flat Agent 43/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessSelf serve

7 APIs 1 MCP Servers

AdvertisingLead GenerationLead AdsMarketing APIFacebookInstagramMetaWebhook

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 56.3/100 · strong

Contract Quality 15.0 / 25

Developer Ergonomics 15.4 / 20

Access Clarity 4.7 / 20

Operational Transparency 9.9 / 13

Contract Governance 2.0 / 12

Discoverability 9.3 / 10

Agent readiness — 43/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/facebook-lead-ads: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Rate Limits 1

Documented rate limits and quota policies.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Facebook Lead Ads Scopes

6 scopes · authorizationCode

6 scopes

SCOPES

Get Started 4

Portal, sign-up, and the first successful call

DeveloperPortal

SignUp

Sandbox

GettingStarted

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 6

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

LlmsText

WellKnown

MCPServer

LLMsTxt

AgentSkill

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Conformance

ErrorCatalog

Lifecycle

Conventions

DataModel

Webhooks

Build 5

SDKs, sample code, and the tooling you integrate with

Packages

SDKs

ToolCrosswalk

CLI

GitHubOrganization

GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

DomainSecurity

DomainSecurity

VulnerabilityDisclosure

VulnerabilityDisclosure

Security

Security

Operate 5

Status, limits, changes, and where to get help

Support

StatusPage

Deprecation

ChangeLog

RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Plans

Plans

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 2

Properties that don't map to a standard resource type

Marketing API

Marketing API

App Dashboard

App Dashboard

Source (apis.yml)

aid: facebook-lead-ads
name: Facebook Lead Ads
description: Facebook Lead Ads (part of the Meta Marketing API) lets advertisers create instant lead-generation forms on Facebook
  and Instagram and programmatically retrieve the leads captured through those forms. Through the Meta Graph API developers
  can list lead generation forms on a Page, read submitted leads, download bulk lead exports, and subscribe to webhooks for
  real-time lead delivery. Authentication uses Page access tokens issued via Facebook Login / Meta Business Login with the
  leads_retrieval, pages_show_list, and pages_manage_ads permissions.
type: Index
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/facebook-lead-ads.png
tags:
- Advertising
- Lead Generation
- Lead Ads
- Marketing API
- Facebook
- Instagram
- Meta
- Webhook
tags_raw:
- Advertising
- Lead Generation
- Lead Ads
- Marketing API
- Facebook
- Instagram
- Meta
- Webhooks
url: https://raw.githubusercontent.com/api-evangelist/facebook-lead-ads/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-08-14'
specificationVersion: '0.23'
apis:
- aid: facebook-lead-ads:graph-api
  name: Meta Marketing API - Lead Ads
  description: Graph API endpoints for managing Facebook and Instagram lead generation forms, retrieving captured leads, exporting
    bulk lead data, and subscribing to leadgen webhooks. Authentication uses Page access tokens with leads_retrieval, pages_show_list,
    and pages_manage_ads permissions.
  humanURL: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  baseURL: https://graph.facebook.com
  tags:
  - Lead Ads
  - Lead Generation
  - Marketing API
  - Graph API
  - Webhook
  tags_raw:
  - Lead Ads
  - Lead Generation
  - Marketing API
  - Graph API
  - Webhooks
  properties:
  - type: Documentation
    url: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  - type: APIReference
    url: https://developers.facebook.com/docs/marketing-api/reference/
  - type: Retrieving Leads
    url: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/retrieving
  - type: Webhooks
    url: https://developers.facebook.com/documentation/ads-commerce/marketing-api/guides/lead-ads/quickstart/webhooks-integration
- aid: facebook-lead-ads:facebook-lead-ads-bulk-leads-api
  name: Facebook Lead Ads Bulk Leads API
  description: The Bulk Leads API from Facebook Lead Ads — 1 operation(s) for bulk leads.
  humanURL: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  baseURL: https://graph.facebook.com
  tags:
  - Bulk Leads
  properties:
  - type: OpenAPI
    url: openapi/facebook-lead-ads-bulk-leads-api-openapi.yml
  - type: Overlay
    url: overlays/facebook-lead-ads-bulk-leads-api-overlay.yaml
- aid: facebook-lead-ads:facebook-lead-ads-leadgen-forms-api
  name: Facebook Lead Ads Leadgen Forms API
  description: The Leadgen Forms API from Facebook Lead Ads — 1 operation(s) for leadgen forms.
  humanURL: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  baseURL: https://graph.facebook.com
  tags:
  - Leadgen Forms
  properties:
  - type: OpenAPI
    url: openapi/facebook-lead-ads-leadgen-forms-api-openapi.yml
  - type: Overlay
    url: overlays/facebook-lead-ads-leadgen-forms-api-overlay.yaml
- aid: facebook-lead-ads:facebook-lead-ads-leads-api
  name: Facebook Lead Ads Leads API
  description: The Leads API from Facebook Lead Ads — 2 operation(s) for leads.
  humanURL: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  baseURL: https://graph.facebook.com
  tags:
  - Leads
  properties:
  - type: OpenAPI
    url: openapi/facebook-lead-ads-leads-api-openapi.yml
  - type: Overlay
    url: overlays/facebook-lead-ads-leads-api-overlay.yaml
- aid: facebook-lead-ads:facebook-lead-ads-meta-marketing-api-lead-ads-api
  name: Facebook Lead Ads Meta Marketing API Lead Ads API
  description: The Meta Marketing API Lead Ads API from Facebook Lead Ads — 2 operation(s) for meta marketing api lead ads.
  humanURL: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  baseURL: https://graph.facebook.com
  tags:
  - Meta Marketing API Lead Ads
  properties:
  - type: OpenAPI
    url: openapi/facebook-lead-ads-meta-marketing-api-lead-ads-api-openapi.yml
  - type: Overlay
    url: overlays/facebook-lead-ads-meta-marketing-api-lead-ads-api-overlay.yaml
- aid: facebook-lead-ads:facebook-lead-ads-subscribed-apps-api
  name: Facebook Lead Ads Subscribed Apps API
  description: The Subscribed Apps API from Facebook Lead Ads — 1 operation(s) for subscribed apps.
  humanURL: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  baseURL: https://graph.facebook.com
  tags:
  - Subscribed Apps
  properties:
  - type: OpenAPI
    url: openapi/facebook-lead-ads-subscribed-apps-api-openapi.yml
  - type: Overlay
    url: overlays/facebook-lead-ads-subscribed-apps-api-overlay.yaml
- aid: facebook-lead-ads:facebook-lead-ads-subscriptions-api
  name: Facebook Lead Ads Subscriptions API
  description: The Subscriptions API from Facebook Lead Ads — 1 operation(s) for subscriptions.
  humanURL: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
  baseURL: https://graph.facebook.com
  tags:
  - Subscription
  tags_raw:
  - Subscriptions
  properties:
  - type: OpenAPI
    url: openapi/facebook-lead-ads-subscriptions-api-openapi.yml
  - type: Overlay
    url: overlays/facebook-lead-ads-subscriptions-api-overlay.yaml
common:
- type: AgenticAccess
  url: agentic-access/facebook-lead-ads-agentic-access.yml
- type: Authentication
  url: authentication/facebook-lead-ads-authentication.yml
- type: OAuthScopes
  url: scopes/facebook-lead-ads-scopes.yml
- type: Website
  url: https://www.facebook.com/business/ads/lead-ads
- type: Documentation
  url: https://developers.facebook.com/docs/marketing-api/guides/lead-ads/
- type: DeveloperPortal
  url: https://developers.facebook.com
- type: Marketing API
  url: https://developers.facebook.com/docs/marketing-api/
- type: SignUp
  url: https://developers.facebook.com/async/registration/
- type: App Dashboard
  url: https://developers.facebook.com/apps/
- type: Support
  url: https://developers.facebook.com/support/
- type: LlmsText
  url: https://developers.facebook.com/llms.txt
- type: Packages
  url: packages/facebook-lead-ads-packages.yml
- type: SDKs
  url: packages/facebook-lead-ads-packages.yml
- type: WellKnown
  url: well-known/facebook-lead-ads-well-known.yml
- type: MCPServer
  url: mcp/facebook-lead-ads-mcp.yml
- type: ToolCrosswalk
  url: mcp/facebook-lead-ads-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/facebook-lead-ads-llms.txt
- type: Conformance
  url: conformance/facebook-lead-ads-conformance.yml
- type: ErrorCatalog
  url: errors/facebook-lead-ads-problem-types.yml
- type: Lifecycle
  url: lifecycle/facebook-lead-ads-lifecycle.yml
- type: StatusPage
  url: https://metastatus.com/marketing-api
- type: Deprecation
  url: https://developers.facebook.com/docs/graph-api/guides/versioning
- type: ChangeLog
  url: changelog/facebook-lead-ads-changelog.yml
- type: DomainSecurity
  url: security/facebook-lead-ads-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/facebook-lead-ads-vulnerability-disclosure.yml
- type: Security
  url: https://bugbounty.meta.com/
- type: Sandbox
  url: sandbox/facebook-lead-ads-sandbox.yml
- type: Conventions
  url: conventions/facebook-lead-ads-conventions.yml
- type: CLI
  url: cli/facebook-lead-ads-cli.yml
- type: DataModel
  url: data-model/facebook-lead-ads-data-model.yml
- type: Webhooks
  url: asyncapi/facebook-lead-ads-webhooks.yml
- type: AgentSkill
  url: skills/_index.yml
- type: RateLimits
  url: rate-limits/facebook-lead-ads-rate-limits.yml
- type: Plans
  url: plans/facebook-lead-ads-plans-pricing.yml
- type: APIReference
  url: https://developers.facebook.com/docs/marketing-api/reference/
- type: GettingStarted
  url: https://developers.facebook.com/docs/marketing-api/get-started
- type: Blog
  url: https://developers.facebook.com/blog/
- type: GitHubOrganization
  url: https://github.com/facebook
- type: TermsOfService
  url: https://developers.facebook.com/terms/
- type: PrivacyPolicy
  url: https://www.facebook.com/privacy/policy/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-enrichment:
  date: '2026-08-14'
  status: enriched
  artifacts_added: 29
  pass: local-v1