> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Lead Ads

> How to set up the Facebook Lead Ads connector, plus the actions that are available.

![Facebook Lead Ads](https://stackone-logos.com/api/facebook/filled/svg)

Previewv2.0.0[See changelog](https://docs.stackone.com/connectors/facebookleadads/changelog.md)

[8 actions](#actions) · 2 auth methods

Advertising

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/facebookleadads/guides/connector-profile/oauth-2-0.md)
>
> Requires a Meta App with Facebook Login for Business configured, the leads\_retrieval and pages\_manage\_ads permissions, a...

> [card] [System User Access Token · Connector Profile](https://docs.stackone.com/connectors/facebookleadads/guides/connector-profile/system-user-access-token.md)
>
> For server-to-server lead sync without a browser OAuth flow. Generate a System User access token in Meta Business Settin...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/facebookleadads/guides/link-account/oauth-2-0.md)

> [card] [System User Access Token · Link Account](https://docs.stackone.com/connectors/facebookleadads/guides/link-account/system-user-access-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

leads\_retrieval

pages\_manage\_ads

pages\_show\_list

public\_profile

No scopes found

8 actions

ActionDescriptionRequired scopes

List Lead Gen Forms`facebookleadads_list_leadgen_forms`

List lead generation forms for a Facebook Page

`pages_manage_ads`

Get Lead Gen Form`facebookleadads_get_leadgen_form`

Get details for a specific lead generation form

`pages_manage_ads`

Create Lead Gen Form`facebookleadads_create_leadgen_form`

Create a lead generation form for a Facebook Page

`pages_manage_ads`

List Leads By Ad`facebookleadads_list_leads_by_ad`

Get all leads for a specific ad

`leads_retrieval``pages_manage_ads`

List Leads By Form`facebookleadads_list_leads_by_form`

Get all leads for a specific form

`leads_retrieval``pages_manage_ads`

Get Lead`facebookleadads_get_lead`

Get details for a specific lead

`leads_retrieval``pages_manage_ads`

Get Me`facebookleadads_get_me`

Get the profile of the authenticated user. Retrieving the email field requires the `email` scope to be granted.

`public_profile`

List My Accounts`facebookleadads_list_my_accounts`

List the Pages managed by the authenticated user

`pages_show_list`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.