This application does not need additional settings. So you can make connection only by using your login credentials or by following the instructions below.
Redirect url

Facebook Lead Ads

Getting Started With Facebook Lead Ads

The Facebook Lead Ads modules allow you to monitor form filling and retrieve form data from your Facebook Lead Ads.


  • A Facebook account
  • A Facebook Page (and a Lead Ad Form created)
  • A Facebook Business Manager account

In order to use Facebook Lead Ads with Integrator, it is necessary to have a Facebook account. If you do not have a Facebook account, you can create one at

You also need a Facebook Business Manager account. Create one at

[Note] Note
The module dialog fields that are displayed in bold (in the Integrator scenario, not in this documentation article) are mandatory!

Connecting Your Facebook Account to Integrator

[Note] Note
See our instructional video FB Lead manual and troubleshooting.

To connect Facebook Lead Ads to Integrator, you must first connect your Facebook account to Integrator. To do so, follow the general instructions for Connecting to services.

After you click the Continue button, Integrator will redirect you to the Facebook website, where you will be prompted to grant Integrator access to your account and permission to manage your Facebook Page(s).

Proceed as described in the following screenshots:


After the last dialog is confirmed, the connection to your Facebook account is established.

Scenario Template:

[Note] Note
You can start with the prebuilt template or build your scenario from scratch. It’s up to you. If you’d like to use the template, here is the link: FB Lead Ads to Google Sheets: Template.

Assigning Access to Integrator in the Facebook Business Manager

In order to work with Facebook Leads Ads, it is necessary to grant access to the Integrator integration in your Facebook Business Manager account.

  1. Log in to your Facebook Business Manager account.
  2. Open the Business Settings.
  3. 3. Go to Integrations > Leads Access.
  4. Go to CRMs, and select Integrator by clicking the checkbox.
  5. Click on the Assign Access button.


[Note] Note
You can use the Lead Ads Testing Tool to test your New Lead module and see if it is receiving the form.

New Lead

Triggers when a new lead is created and retrieves the form values.

Establish a connection to your Facebook account

Select the page that contains the form you want to watch.

Select the form you want to watch for new submissions. If the field is left empty, all form submissions from the selected page are retrieved.

Get Lead Details

Retrieves the filled-in values of the form that the user has submitted.

Establish a connection to your Facebook account

Select the page that contains the form you want to retrieve the information from.

Select the form you want to get data from.

The form you want to retrieve the data from has to have been submitted at least once before, otherwise the form won’t load in the Integrator module.

Lead ID
Enter the ID of the desired form.


Get a Form

Retrieves the form information.

Establish a connection to your Facebook account

Select the page that contains the form you want to retrieve the details about.

Form ID
Select or map the ID of the form you want to retrieve the details about.

Unsubscribe a Webhook

Deleting a scenario will not automatically unsubscribe your Facebook Page from receiving event notifications from Facebook.

Use this module to stop subscribing to event notifications.

Running the Unsubscribe a Webhook module once will unsubscribe all your scenarios that contain the Watch Form Filling trigger from receiving webhook events.


The New Lead Module Does Not Trigger

If the module does not trigger when the data has been sent to it, try the following steps:

  1. Open your Facebook settings > Business Integrations, and remove the Integrator app.
  2. Go to Integrator, and remove the connection you use for the Facebook Lead Ads trigger from Integrator.
  3. Create the connection again by following the steps in the Connecting Facebook Account to Integrator section.
  4. Go to the People Business Settings if you are an individual, or to the Partner Business Settings if you are a partner.
  5. Select Integrator (in case of Partnersettings), or your name (in case of Peoplesettings), and enable the following permissions:
    • Manage Page permission for the Pages asset


    • Manage Ad Account for the Ad Accounts asset.


  6. Navigate to Integrations > Leads Access, and check that Integrator (for Partners) or you (for People) have access to your page.

The Integrator Dropdown Doesn’t Show Some Facebook Pages:

If some of your pages are not available in the Integrator modules, please follow the steps below:

  1. Open the Facebook Settings, and click on Business Integrations, or use this link:
  2. Open the Integrator app.
  3. Check off all of the pages you want to see in the Integrator modules
  4. Save the changes by clicking the Save button.

The Scenario Does Not Start After Submitting a Form

  1. Check whether the Integrator app is subscribed to your page by checking the Lead Ads Testing Tool. Once the webhook is correctly connected to If you still see an issue, open the Business Manager, and assign access to Integratoryour page, you should see the WEBHOOK SUBSCRIPTION FOR THE SELECTED PAGE area as shown in the picture below:
  2. If your scenario is set up correctly but does not start after submitting a form, please check in the Facebook Business manager to make sure that Integrator has access to your page.To do so, click on the Leads Access tab, select a page, and click on the CRM to assign access for Integrator (if it is not already allowed).

    If you still see an issue, open the Business Manager, and assign access to Integrator:


    If none of this works, please try to add a new Facebook connection, and follow the same steps.

400: GraphMethodException (100): Unsupported Get Request.

This error may occur for some users:


Please use the Ignore error handler option (under advanced settings) to fix this error.


For example, when we collect the ad and campaign ID instead of the module throwing an error and stopping the scenario the ignore error handler will take care of it.

OAuthException (200)


You may see this error message if your role on the page is Advertiser or Analyst.

To solve this issue and use the module, you must be an Admin, Moderator, or Editor of the page from which you are trying to get leads ads.


Do you need help with something specific regarding Facebook Lead Ads?

We are here for you.

Get support on the road to success from real experts.

We will help you set up your business processes, create connections from your current IT stack, and set up data analysis.

  • Chat, phone & e-mail
  • Support teams across the world
  • 2 hours average response time
Get in touch