Facebook Lead Ads Help & Support

How to Get Started with Facebook Lead Ads on Zapier

Note: Facebook Lead Ads is a premium app. This means you need to be on either a free trial or one of our paid plans in order to use this app.

1. Check your Facebook Lead Ads Account Settings

If you are using Facebook Business Manager, before you can connect your Facebook Lead Ads to Zapier you will need to check that you have the correct permissions. You’ll need to have admin access for the page you want to use and the ad account as well as leads access. This can differ depending if your account is a Partners or People account.

If you're having trouble setting these permissions, it probably means you do not have the admin access you need. Speak to your Facebook business admin and they will be able to implement these changes for you. More information on controlling access to your leads can be found in Facebook's documentation.

2. Connecting your Facebook Lead Ads Account to Zapier

Now that you've got your permissions set up in Facebook Lead Ads, you can now connect your Facebook Lead Ads account to Zapier.

Note - It's expected behaviour for your personal Facebook account to appear, as this is linked to your Business Manager account.

With your account connected, click "Continue".

3. Setting your trigger options

Here you will need to select the Facebook Page, select the Form you wish to trigger off.

Tip - If you select "Default" on Form this will allow you to trigger on all the forms linked to your Facebook Page.

Alert - If you're not able to see your Facebook Page in the dropdown, follow our instructions in this help doc to fix this.

If all steps were successful your Facebook Lead Ads account will now be successfully connected.

4. Testing your Facebook Lead Ads Zap

To test your Zap, you can either do this two ways:

1.Use the Test Lead generated by Facebook. It will be generic and not contain any custom fields.
2. Use the Facebook Lead Ad testing tool to create a Lead (it will include any custom fields you have created on your form, including those not in English).

If you run into any issues when trying to test your Zap, check out our Facebook Lead Ads Common Problems page.

Alert - Leads or Test Leads not triggering as expected once the Zap is turned on? Follow our help doc with instructions on how to fix that. If they can see the pages, and don’t get an error when testing, use this troubleshooting tutorial to resolve it.

5. Maintenance for your Facebook Lead Ads Zap

Changes to your form

If you make any changes to your form, be sure to re-select it in your trigger options (see Step 3. Note the form will get a new name with any revisions made.

Changes to passwords or permissions on your Facebook account

Changes to your password or permissions linked to your Facebook Lead Ads will cause for your connection on Zapier to break. If this happens be sure to:
- [Make sure settings are updated]((https://zapier.com/apps/facebook-lead-ads/help#1-check-your-facebook-lead-ads-account-settings)
- Reconnect your account in My Apps

Popular Facebook Lead Ads Integrations

  • Send emails from Gmail for new Facebook Lead Ads leads

    Facebook Lead Ads + Gmail

    Try It
  • Get emails with new Facebook Lead Ads leads

    Facebook Lead Ads + Email by Zapier

  • Add new Facebook Lead Ads leads to rows on Google Sheets

    Facebook Lead Ads + Google Sheets

  • Subscribe new Facebook Lead Ad leads to a MailChimp list

    Facebook Lead Ads + Mailchimp

  • Add or update ActiveCampaign contacts with new Facebook Lead Ads leads

    Facebook Lead Ads + ActiveCampaign

See more Facebook lead ads integrations

Facebook Lead Ads Tips and Tricks

Using the Facebook Lead Ads Testing Tool

You may need to test Facebook Lead Ads, and you want to use a sample contact other than Facebook would pick up from your login. You can do that using the Facebook Lead Ads Testing Tool.

  1. Go to Facebook’s Leads Ads Testing Tool here: https://developers.facebook.com/tools/lead-ads-testing/
    ​​
  2. Select your Page & Form
  3. Click on “Delete Lead” (Don’t worry — it won’t delete any live leads, just Facebook’s example lead)
  4. Click on “Preview Form”
  5. Fill out your form like normal
  6. Click "Submit"

Common Problems with Facebook Lead Ads

Overview

Facebook Lead Ads Setup

Common Problems

Common Errors

Everything Was Working, but Now It Isn’t


What account permissions do I need to use Facebook Lead Ads with Zapier?

You’ll need to have admin access for the pages, the ad account and leads access. This is a bit different if you are a partner or if you have been added to the business as an individual.

Account Permissions - Partners Account

If you are a business partner, you'll want to head to the Partners tab of that business. You can verify your permissions, and if they don't look like this below for the page in question, you'll need to have a Facebook Business Admin give you these permissions:

Manage Pages

Manage Ad Account

Leads Access

Account Permissions - People Account

If you have been added as an individual/employee, you'll want to head to the People tab of that business. You can verify your permissions for Pages and Ad Accounts, and if they don't look like this below for the page in question, you'll need to have a user with an Admin role give you these permissions.

Manage Pages

Manage Ad Account

You'll also need Leads Access permissions, which is in a different tab. If you don't see that tab, you'll need an Admin user to do this for you. You need to be added to the People list for the page in question, a screenshot of that is below:

Leads Access

Facebook Lead Ad permissions can be complex, especially with multiple partners and individuals. If you continue to have issues, we recommend you dig into Facebook's guide here.. If you find you're still running into issues, contact support and we'd be happy to help!


I Have a Business Manager Account but Zapier Is Connecting My Personal Facebook Account

This is expected behavior as your personal Facebook account is linked to your Facebook Lead Ads Business Manager account. Any Pages/Ad Accounts that you've been assigned to in Business Manager are available when you connect your personal Facebook account.


I’m Receiving New Leads in Facebook, but My Zap Is Not Running

If your Zap is turned on and you are receiving leads in Facebook, but your Zap is not being triggered, there are a few things that you can do to fix this:

1. Page, Ad Account, Lead Access Admin Access

Check your Facebook account has admin permissions for these three areas. More info can be found here.

2. Re-select your form

Have you recently changed the name of your form? Re-select the form from the dropdown to refresh your settings:

3. Check the Facebook Lead Ads testing tool for any errors

  • Visit the Lead Ads testing tool page
  • Select the Page and Form
  • Click "Create Lead"
  • Click the "Track Status" button
  • Review the section below "Track Status" for any errors or messages
  • If you see the 103 error, "CRM access has been revoked from Lead Access Manager", you can reset the Facebook Leads Access permissions.

4. CRM Access Permissions for Zapier

Zapier might not have access to this page. Follow these instructions to update and/or reset your Zapier access here.


The Page I Need to Use Is Not Showing in My Zap

If you cannot select a page you have adequate permissions for, there may be some cached permissions for that page that need to be updated.

The easiest method to resolve this is to update and/or reset your Zapier access here.


My Test Step Sample Doesn't Have My Custom Form Fields

If your form has never been used, you'll just see one generic test lead with default fields (in NA English) in your Test Step sample. If you have custom fields you need to use, including those that are not NA English, you can submit a new test lead with this info:

  1. Visit the Lead Ads testing tool page
  2. Select the page and form (lead ad) used in this integration
  3. (Optional) Click on "Preview form" to fill out the form
  4. Click "Create lead"
  5. Return to the Zap editor and use the Test Step to get another sample

NOTE: If you've already used this tool to send a lead you'll have to delete that lead before you can submit another one.

delete-lead


My existing leads in Facebook didn't trigger the Zap

Zapier will not be able to see leads that were created before your Zap was turned on; we can only trigger off of leads that have been newly added to the trigger app.

One workaround to import leads that were created prior to the Zap being turned on is to follow these instructions to download your Facebook leads as a comma-separated values file (CSV file). With a CSV file in-hand, you can semi-manually copy records into a Google Spreadsheet to trigger a Google Spreadsheet Zap. Be wary of rate limits. You can check out this guide for more information on how to do this.


I'm Only Seeing Old Leads When I Use the Test Step to get Sample Data

If you're trying to get the most recent lead to come through (perhaps because it has a new field you need to use), make sure that you have a specific form selected in the Form menu.

trigger options

If you don't have a form selected here, Zapier will retrieve samples from your oldest form to your newest form, so likely not a new lead. When you select a form, however, the samples will be retrieved from that form newest to oldest, so you'll be able to use the most recent leads to map appropriate fields.


Facebook Lead Ads Is Returning ad_id as 0

This is caused by the lead being sent from the Facebook testing tool. It was not an organic lead. When you map that field, you can expect it to work once the Zap is running.


Facebook Lead Ads gives me a full name but I need first and last

There are a couple of things you can do if you run into this.

  • Change the Lead Ads form to include First Name and Last Name instead of Full name

change form

  • Use our Formatter app to split the name into 2 parts:

Remove connection from Zapier to your Facebook Lead Ads account

To remove Zapier access to your Facebook Lead Ads follow these steps:

  • Turn off all Zaps connected to Facebook Lead Ads
  • Disconnect your Facebook Lead Ads in your My Apps
  • Follow Facebook's instructions on how to remove your leads access from Business Manager. You must be a page owner to do this.
  • Finally, remove it from your Business Integration Leads Setup page. It can take up to 12 hours for this connection to be removed.

Revoke Access to Zapier - My Facebook Lead Ads is still showing as connected in Business Manager

In cases where you are not able to remove your connection, you can try this workaround to force through the disconnect:

  1. Create a new Zap that connects Facebook Lead Ads to any app. You can click this link to create a Zap that connects FBLA to Gmail: https://zapier.com/app/editor/template/10146
  2. Connect your Facebook Lead Ads account, and set up the Zap to the point where it can be turned on.
  3. Turn the Zap on, then off.

Once the Zap is turned off, that should clear Zapier from the list of connected apps in Facebook Business Manager. It may take up to 12 hours for Facebook to display the changes, but will eventually be removed.

Any further problems, contact our support team and we can assist further.


Error: "CRM access has been revoked from Lead Access Manager"

To fix this error message, reset the Facebook Leads Access permissions.


Error: "Problem creating webhook subscription" or "Webhook subscription not found"

  • Check your permissions here.
  • Once these are verified, update and/or reset your Zapier access here.

Error: "Invalid permission issue with Facebook, ensure this account can access the page."

  • Check your permissions here.
  • Once these are verified, update and/or reset your Zapier CRM access here.

Error: "Validating access token: Session does not match current stored session"

If you're seeing this error, it's likely because you changed your password in Facebook. You'll need to reconnect your account in Zapier. You can do that by going to the Connected Accounts page and clicking the reconnect button next to Facebook Lead Ads, then typing in your credentials.


Error: "Custom Audience Terms Not Accepted"

When using the action "Create Custom Audience", the Zap returns the following error:

Custom Audience Terms Not Accepted. You'll need to agree to the Custom Audience terms before you can create or edit an audience of CUSTOM type. To accept, go to https://www.facebook.com/ads/manage/customaudiences/tos/

In July 2018, Facebook made a change in their site, which requires all users to acknowledge/approve their Terms of Service before creating any new custom audiences. This will only need to be performed once for your Facebook Leads account.


How to reset CRM access for Zapier

First, verify these permissions, it's possible an update might work

  • Go here and click on Zapier.
  • Verify that these settings are turned on for Zapier, and if you have a list of pages, that Zapier has access to the page you want to use in your Zap
  • Reconnect Facebook Lead Ads again here, this should update Zapier's view of permissions to the pages you have Lead Access to.
  • Test your Zap again. If it continues to not work, do a full reset.

Full Reset

  • Go back to this page
  • Click on the checkbox next to Zapier and click Remove. Ignore the option to delete posts.
  • Reconnect Facebook Lead Ads again here and this will add Zapier back, with default permissions to the pages you have Lead Access to.
  • Keep in mind that this full reset will affect all of your Zaps using this user's account while Zapier is disconnected. If you have more than one Zapier account or other people using this Facebook login, you may wish to notify them before you do so.

More information on how to grant more granular permissions can be found in Facebook's guide here. If it's the case that Zapier isn't showing up for you at all after reconnecting, then this tutorial can assist further.


How to reset Facebook Lead Access permissions

This assumes you are using Facebook Business Manager.

  • Navigate to the page in question under the Leads Access Tab - https://business.facebook.com/settings/leads-accesses
  • If you don’t see the Leads Access tab, or your page listed, then you don’t have the rights to set Leads Access permissions, you’ll need to contact the page owner set these permissions for your account.

The permissions you see for the Page will depend on if you own the page, are an employee, or are a partner.

If you own the page:

  • Make sure the Facebook account used in Zapier has access in the People or Partner list.
  • Make sure that Zapier is not disabled under the CRM tab.
  • You can also reset all Lead Access permissions for that page using “Restore Default Access” at the top-right of the page: Facebook Lead Ad Restore Default Access

If you don't own the page:

  • You'll only be able to assign People access. Make sure the Facebook account used in Zapier has access in the People list.

Facebook Lead Ads error: “Could not get the access_token for this page.”

Symptoms

After attempting to test a Facebook Lead Ads step you may see an error that says “Could not get the access_token for this page.”

Causes

This error can happen when you do not have admin permissions for the page you are attempting to connect.

How to fix it

First, check that you have the correct permissions set up in your Facebook Lead Ads account. You can learn more about the permissions needed here.

If that doesn’t fix it, try reconnecting your Facebook Lead Ads account:

  1. Go to My Apps
  2. Find your Facebook Lead Ads account and click Reconnect
  3. Follow the instructions to reconnect your account

After reconnecting your account, re-test your step in the Zap editor.

If reconnecting your account still doesn’t solve the problem, reset Zapier’s access to Facebook Lead Ads by following these steps

Connect the apps you use every day

Get started with a Free account

Or
By signing up, you agree to Zapier’s Terms of Service