Skip to content

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 Ibexa Connect, 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


The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Your Facebook Account to Ibexa Connect


See our instructional video FB Lead manual and troubleshooting.

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

After you click the Continue button, Ibexa Connect will redirect you to the Facebook website, where you will be prompted to grant Ibexa Connect 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:


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 Ibexa Connect in the Facebook Business Manager

In order to work with Facebook Leads Ads, it is necessary to grant access to the Ibexa Connect 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 Ibexa Connect by clicking the checkbox.

  5. Click on the Assign Access button.




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.

Account Establish a connection to your Facebook account
Page Select the page that contains the form you want to watch.
Form 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.


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 Ibexa Connect module.

Lead ID

Enter the ID of the desired form.


Get a Form

Retrieves the form information.

Account Establish a connection to your Facebook account
Page 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 Ibexa Connect app.


  2. Go to Ibexa Connect, and remove the connection you use for the Facebook Lead Ads trigger from Ibexa Connect.


  3. Create the connection again by following the steps in the Connecting Facebook Account to Ibexa Connect 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 Ibexa Connect (in case of ***Partner***settings), or your name (in case of ***People***settings), 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 Ibexa Connect (for Partners) or you (for People) have access to your page.


The Ibexa Connect Dropdown Doesn't Show Some Facebook Pages:

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

  1. Open the Facebook Settings, and click on Business Integrations, or use this link:

  2. Open the Ibexa Connect app.


  3. Check off all of the pages you want to see in the Ibexa Connect modules


  4. Save the changes by clicking the Save button*.*

The Scenario Does Not Start After Submitting a Form

  1. Check whether the Ibexa Connect 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 Ibexa Connectyour 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 Ibexa Connect 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 Ibexa Connect (if it is not already allowed).

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


    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.