Facebook Lead Ads OAuth Scopes

OAuth 2.0 derived

Facebook Lead Ads publishes 3 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Facebook Lead Ads API on a user’s behalf.

Tokens are issued from https://graph.facebook.com/v22.0/oauth/access_token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

AdvertisingLead GenerationLead AdsMarketing APIFacebookInstagramMetaWebhooks

Scopes: 3 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://www.facebook.com/v22.0/dialog/oauth

Token URL
https://graph.facebook.com/v22.0/oauth/access_token

Flows
authorizationCode

Scopes (3)

Scope	Description	Flows
leads_retrieval	Read leads from lead ad forms	authorizationCode
pages_manage_ads	Manage ads associated with a Page	authorizationCode
pages_show_list	List Pages the user manages	authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-07-11'
method: derived
source: openapi/facebook-lead-ads-openapi.yml
schemes:
- name: PageAccessToken
  source: openapi/facebook-lead-ads-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://www.facebook.com/v22.0/dialog/oauth
    tokenUrl: https://graph.facebook.com/v22.0/oauth/access_token
  description: |-
    Page access token obtained via Facebook Login / Meta Business
    Login with leads_retrieval, pages_show_list, and
    pages_manage_ads permissions.
scopes:
- scope: leads_retrieval
  description: Read leads from lead ad forms
  flows:
  - authorizationCode
  sources:
  - openapi/facebook-lead-ads-openapi.yml
- scope: pages_manage_ads
  description: Manage ads associated with a Page
  flows:
  - authorizationCode
  sources:
  - openapi/facebook-lead-ads-openapi.yml
- scope: pages_show_list
  description: List Pages the user manages
  flows:
  - authorizationCode
  sources:
  - openapi/facebook-lead-ads-openapi.yml