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.

Facebook Lead Ads’ developer surface includes authentication, documentation, signup flow, support, and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub

27.3/100 emerging ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessSelf serve

7 APIs

AdvertisingLead GenerationLead AdsMarketing APIFacebookInstagramMetaWebhooks

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 27.3/100 · emerging

Contract Quality 13.4 / 25

Developer Ergonomics 6.5 / 20

Commercial Clarity 0.0 / 20

Operational Transparency 0.0 / 13

Governance 0.0 / 12

Discoverability 7.4 / 10

Agent readiness — 28/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 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.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Facebook Lead Ads Scopes

3 scopes · authorizationCode

3 scopes

SCOPES

Get Started 2

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

Signup

Signup

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

LlmsText

LlmsText

Access & Security 2

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

Operate 1

Status, limits, changes, and where to get help

Support

Support

Company 1

The organization behind the API

Website

Website

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
- Webhooks
url: https://raw.githubusercontent.com/api-evangelist/facebook-lead-ads/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-05-11'
specificationVersion: '0.19'
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
  - 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/docs/marketing-api/guides/lead-ads/quickstart-webhook
- 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
- 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
- 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
- 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
- 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
- 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:
  - Subscriptions
  properties:
  - type: OpenAPI
    url: openapi/facebook-lead-ads-subscriptions-api-openapi.yml
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
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Facebook Lead Ads

Kin Score

APIs 7

Meta Marketing API - Lead Ads

Facebook Lead Ads Bulk Leads API

Facebook Lead Ads Leadgen Forms API

Facebook Lead Ads Leads API

Facebook Lead Ads Meta Marketing API Lead Ads API

Facebook Lead Ads Subscribed Apps API

Facebook Lead Ads Subscriptions API

Open Collections 1

Meta Marketing API - Lead Ads

Security Posture 1

Facebook Lead Ads Authentication