Facebook Lead Ads

Facebook Lead Ads Help & Support

What Facebook Lead Ads Triggers and Actions are Supported?

Supported Triggers#

  • New Lead - Triggers when a new lead is created.

Supported Actions#

  • None yet!

How to Get Started with Facebook Lead Ads on Zapier

About Facebook Lead Ads' Integration#

  • Admin/owner permissions - You need to be a Page Admin for the page you are collecting leads for, and if you are using Facebook Business Manager to manage your Ad account, your setup must be as either an Ad account advertiser or Ad account admin in Facebook Business Manager for your Ad account. You may also need to give CRM permission to Zapier by adding it to your Facebook page - more on how to do that here.
  • Paid/versioned account - No cost outside of purchasing the ad space from Facebook
  • Custom field support - Yes

Connecting with Facebook Lead Ads#

To get started, connect your Facebook Lead Ads account to Zapier.

With your account connected, click "Continue" in order to select the Facebook Page and Form (Lead Ad) to involve in this Zap.

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

Tip: During your Zap's trigger test stage we'll get some fake dummy data from Facebook. If you want to get a real sample to better map our your Action template with, during your test steps follow this guide to submit a test lead from Facebook.

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

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 lead access. This is a bit different if you are a partner or if you have been added to the business as an individual. 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

Manage Leads Access

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. You'll also need Leads Access permissions, which is in a different tab. Again, 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:

Manage Pages

Manage Ad Account

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..

I’m Receiving New Leads in Facebook, but My Zap Is Not Being Triggered or I see an error in my Zap's Task History.#

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

1. Page, Ad Account, Lead Access Admin Access

Check your Facebook settings 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

To do this follow these instructions:

4. CRM Access for Zapier

If all other options have failed, follow these instructions to reset your CRM Access.

The Page I need to use is not showing in my Zap?#

If you cannot find a Page you have adequate permissions for, there may be some cached permissions for that page.

The easiest method to resolve this is to remove/re-add your Zapier access here.

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

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

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 your Test Step sample. If you have custom fields you need to use, you can submit a new test lead with this info:

  1. Visit developers.facebook.com/tools/lead-ads-testing
  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.


I have a Business Manager account but Zapier is connecting my personal Facebook account#

Permissions for Facebook Lead Ads in Business Manager are assigned to your personal Facebook account. Any Pages/Ad Accounts that you've been assigned to in Business Manager are available when you connect your personal Facebook account.

Error: "Problem creating webhook subscription"#

If you run into this error when trying to test your Facebook Lead Ads Zap, it could be that your linked Facebook account is not an Admin of the page you selected. Check your permissions, see more details of about Facebook Lead Ads 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.

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


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

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.

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.

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 trigger options.

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.

How to reset CRM access to Zapier#

  • Go here and remove Zapier
  • 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 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 a 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#

  • Navigate to the page in question here in Business Manager here: https://business.facebook.com/settings/leads-accesses
  • Make sure the Facebook account you are using in Zapier has access to this page:
  • You (or an Admin) 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

Need More Help? - Our support team is happy to help -- send us a message

Facebook lead ads make signing up for business information easy for people and more valuable for businesses. The Facebook lead ad app is useful for marketers who want to automate actions on their leads.

Learn More

Getting Started with Zapier