Skip to content

Facebook Lead Ads

The Facebook Lead Ads integration starts a recipe on your WordPress site each time someone submits the lead form in one of your Facebook ads. The lead’s answers become tokens you can use in the recipe’s actions: email the lead, add them to your mailing list, or create a WordPress user. This article walks through the Facebook setup the integration depends on, connecting Facebook Lead Ads to Uncanny Automator, building the recipe, and sending a test lead.

If you have Uncanny Automator Lite, you’ll first need to connect your site to a free Uncanny Automator account, which gives you app credits to use with Facebook Lead Ads. On a paid plan, app integrations are included.

Important: Facebook needs every step below before it sends leads to Automator. If one is skipped, leads are not delivered and the recipe never runs.

Before you begin

You need the following in Facebook, with admin access to each of them:

  • A Facebook Business portfolio
  • A Facebook Page linked to that business
  • An ad account linked to the business and the Page
  • A Leads campaign that uses an Instant form

Your WordPress site must also be reachable at a public URL. Facebook delivers leads to your site over the internet, so a local site cannot receive them; on a site Automator detects as local, the Facebook Lead Ads settings page says “Webhooks need the site at a public URL, and this site is local.”

If your Facebook business, Page, ad account, and lead form are already set up, skip to Step 7: Connect Facebook Lead Ads in Automator.

Step 1: Set up your Facebook Business portfolio

Go to business.facebook.com. If you already have a Business portfolio, go on to Step 2. Otherwise:

  1. Click the business menu in the top left corner.
  2. Select Create a business portfolio.

The Meta Business Suite business menu open, with the Create a business portfolio button at the bottom

  1. Enter your business information and follow the prompts until the business is created.

If you already have a Facebook Page connected to the business, go on to Step 3. Otherwise:

  1. Open the menu again, choose Pages, and click Add.

The Pages screen of a Facebook business portfolio with no Pages added and the Add button

  1. Enter the Page name, a category, and the other details Facebook asks for.

The Create Facebook Page dialog with the Page name, Category, and Bio fields filled in

  1. On the confirmation screen, check that the Page is shown under your business portfolio, then create the Page.

The Create Facebook Page confirmation screen showing the new Page linked to the business portfolio, with the Create Page button

Step 3: Set up an ad account and assign access

Check whether your Page has an ad account linked. If it does not:

  1. In your business settings, go to Accounts > Ad accounts.

The Ad accounts screen in Facebook business settings with no ad accounts added and the Add button

  1. Create a new ad account or add an existing one.
  2. Make sure the ad account is linked to your business and the correct Page.

The Create new ad account confirmation screen showing the ad account under the business portfolio

  1. Select the ad account and click Assign people.

An ad account's details in Facebook business settings with the Assign people button

  1. Select a person (you or someone else) and give them at least the Manage campaigns permission, or full control, then click Assign people.

The Assign people dialog with a person selected and the Manage campaigns and Manage ad accounts permissions

Step 4: Open Ads Manager and start a campaign

  1. Open the menu and select Ads Manager.

The Meta Business Suite menu with Ads Manager highlighted

  1. Check that the correct business and ad account are selected at the top.
  2. Click Create to start a new campaign.

The Campaigns screen in Ads Manager with the ad account selector at the top and the Create button

Step 5: Configure your Leads campaign

  1. Select Leads as the campaign objective.

The Create new campaign dialog with Leads selected as the campaign objective

  1. Give the campaign a name you will recognize.

The campaign editor with the Campaign name field highlighted

  1. Under Conversion location, select Instant forms.
  2. Choose your Facebook Page. If Facebook asks you to accept its lead generation terms for the Page, accept them.

The ad set editor with Instant forms selected as the conversion location and the Facebook Page selected

  1. Adjust the budget, audience, and other settings as you need.
  2. Do not publish the campaign yet. Save it as a draft so it does not incur charges while you finish the setup.

Step 6: Create a Facebook lead form

  1. In the ad section of the campaign, under Instant form, click Create a form.

The ad editor with the Create a form option under Instant form

  1. Enter a name for the form.

The Create form dialog with the Form name field filled in

  1. Edit the questions to collect the information you want. Each question becomes a token in your recipe.

The Questions step of the Create form dialog with suggested questions and the Add question button

  1. Preview the form with the built-in preview.
  2. Enter your privacy policy URL.
  3. Set what the thank-you screen shows, or choose a link to send people to.

Step 7: Connect Facebook Lead Ads in Automator

  1. In your WordPress dashboard, go to Automator > Settings > App integrations > Facebook Lead Ads.
  2. Click Connect Facebook Lead Ads account.

The Facebook Lead Ads panel in Automator Settings > App integrations before connecting, with the A new lead is created trigger, the Test your webhook connection box and the Connect Facebook Lead Ads account button

  1. When Facebook asks which Pages Uncanny Automator – Lead Ads can access, select the Page you use for the campaign and click Continue.

Facebook's dialog for choosing the Pages Uncanny Automator - Lead Ads can access, with one Page selected

  1. On the next screen, select the business and click Continue.

Facebook's dialog for choosing the businesses Uncanny Automator - Lead Ads can access, with one business selected

  1. Review the permissions Uncanny Automator – Lead Ads requests and click Save.

Facebook's review screen listing the access Uncanny Automator - Lead Ads requests, with the Save button

  1. Click Got it when Facebook returns you to your site.
  2. Under Connected pages, check that your Page is listed with the status Ready. Each Page shows its Page ID and how its leads are delivered, and Reverify checks the Page’s connection again.
  3. Under Test your webhook connection, click Check webhook delivery. The Automator Platform sends a test request to your site; “Webhook test successful” confirms your site can receive leads.

Until Facebook Lead Ads is connected, the recipe builder’s picker hides it while its Ready-to-use only switch is on.

Check app access in Facebook (optional)

To confirm the connection from Facebook’s side, go to Facebook’s Business Integrations settings and check that Uncanny Automator – Lead Ads appears in the list of active integrations.

Facebook's Business Integrations settings with Uncanny Automator - Lead Ads listed as an active integration

Step 8: Assign Uncanny Automator as a CRM

  1. Return to Facebook Business and select the same business and Page.
  2. Click Settings in the bottom left.
  3. Under Integrations, click Leads Access.
  4. Click Assign CRMs.

The Leads Access screen in Facebook business settings, on the CRMs tab, with the Assign CRMs button

  1. Select Uncanny Automator – Lead Ads and click Assign.

The Add CRMs and set permissions dialog with Uncanny Automator - Lead Ads listed

Step 9: Create the recipe in Automator

A lead comes from Facebook, not from a visitor logged in to your site, so the Facebook Lead Ads trigger works only in a recipe of the Everyone type. In a Logged-in users recipe the picker shows it with the note “This trigger runs for everyone and cannot be used in a recipe for logged-in users.” See Recipe types: logged-in users and everyone.

  1. Go to Automator > Add new recipe, select Everyone, and click Confirm.
  2. Click Add trigger. In the picker, search for Facebook Lead Ads, select it, and select the trigger A new lead is created.
  3. In the Set up step, select your Page, then the Form. If a form you created a moment ago is missing, click Refresh options. Editing a form in Facebook gives it a new form ID, so select the form again here after any change to it.
  4. Click Save.
  1. Click + below the trigger and add the actions you want, such as sending an email or adding the lead to a mailing list. Insert the lead’s answers with the ∗ button at the end of a field; each form question is a token, alongside tokens such as Form ID, Page ID, and Created time (timestamp). If an action needs a WordPress user, set up the Run recipe as card; see Recipes for Everyone.
  2. Switch the recipe on with the Recipe on switch in the top bar.

Note: In a duplicated or imported recipe, the trigger fetches its form question tokens from Facebook when you switch the trigger On. If a copy’s question tokens are missing, check that its trigger is on.

Step 10: Send a test lead

Facebook’s Lead Ads Testing Tool creates a sample lead without running the campaign. Make sure the recipe is on before you send it.

  1. Go to the Lead Ads Testing Tool.
  2. Select the Page you used in your campaign.

The Lead Ads Testing Tool with the Page dropdown open

  1. Select the lead form you created.
  2. Click Create lead.

The Lead Ads Testing Tool with a Page and form selected and the Create lead button

  1. Wait for the confirmation that the test lead was sent.

The Lead Ads Testing Tool confirming that the test lead has been sent, with the Track status button

  1. Click Track status and check that the delivery shows the status success with HTTP code 200.

The Lead Ads Testing Tool status table showing a success status and HTTP code 200 for the test lead

The tool creates one test lead per form. To send another, click Delete lead first.

Step 11: Confirm the lead reached Automator

  1. Open the recipe. In the sidebar, Details shows the number of Completed runs.
  2. Click View logs. Automator > Logs opens, filtered to this recipe.
  1. Click Details on the run. The dialog lists the trigger and each action with its status. Opening the trigger shows its Page and Form settings and when it ran, not the lead’s answers. To see the values a lead supplied, open an action that uses the lead tokens: its fields show the values that were filled in.

See Using Automator Logs for more on reading logs.

Troubleshooting

If the test lead does not produce a recipe run:

  • Check that the Page, business, and ad account are linked to each other in Facebook.
  • Check that you granted every permission when you connected.
  • Check that Uncanny Automator – Lead Ads is assigned as a CRM under Leads Access.
  • Check that the recipe is switched on and that its trigger uses the form you sent the lead from.
  • If a Page under Connected pages asks you to reconnect Facebook, or is missing, disconnect, connect again, and select that Page when Facebook asks.

Related: Recipes for Everyone, Managing tokens, Finding integrations in the recipe builder, Facebook Pages

Comments (0)

Leave a Reply

Your email address will not be published. Required fields are marked *

Back To Top