Skip to content
FoxFlowDocs

Facebook and Instagram Lead Ads

Connect your Facebook Page once, choose which lead forms feed which flow, and watch ad leads land on your board.


If you run lead ads, this is the integration that matters. A lead fills out your form on Facebook or Instagram, and a card appears on your board seconds later.

How It Works

Facebook pushes leads to FoxFlow the moment they're submitted — FoxFlow isn't polling or checking periodically.

Someone submits your Lead Ad form
   → Facebook notifies FoxFlow immediately
   → FoxFlow creates a lead on every flow set up for that form
   → assignment, scripts and auto-send all run as normal

The practical consequence: a lead who filled out your form while watching TV can have a text from you before they've put their phone down. That's the entire advantage, and it's worth building your setup around.

Connecting

Two levels, in this order.

1. Connect the Page (organisation). In Organization Settings → Meta, use Easy Connect to sign in with Facebook and authorise FoxFlow. There's also a Manual Connect option using a System User token and Page ID, for teams whose agency manages Facebook access.

2. Choose the forms (flow). In Flow Settings → Meta, pick which of your lead forms should feed this board.

One Form, or Several Flows

Because form selection is per flow, you can point different campaigns at different boards with different scripts:

You can also point the same form at two flows if two teams genuinely both need it, though it's usually a sign the flows should be one.

Lead Access Health

Facebook permissions expire, get revoked when someone leaves, or break when Page roles change. When that happens leads stop arriving, and nothing looks obviously wrong.

The Lead Access Health card on the org Meta tab exists for this. It reports:

StatusMeaning
Lead access healthyWorking
Lead access lostPermission expired or revoked — reconnect
Configured forms missingA form a flow expects no longer exists on Facebook
Last check inconclusiveFacebook didn't answer clearly; check again later
Health not yet checkedNo check has run yet

Flows also show their own badge when access is lost or a selected form has disappeared.

What Arrives on the Lead

Whatever the form collected — name, email, phone, plus every custom question — along with which form and Page it came from. That form name is available in scripts as {form_name}, which is handy when one flow serves more than one ad:

Hi {first_name}, thanks for your interest in {form_name}.

Conversion Reporting

When a Facebook or Instagram lead reaches a flow's conversion step, FoxFlow can tell Meta. Meta then has a signal to aim ads at people who look like the ones who converted.

In Organization Settings → Meta, after the Page is connected, open Conversion Reporting and paste two values from Meta Events Manager:

  1. Create a CRM dataset, or convert an existing dataset to CRM.
  2. Generate a Conversions API access token for that dataset.
  3. Paste the dataset ID and the token. Leave the test event code empty except while you are checking Events Manager's test view. Events sent with a test code do not train ads. Clear the code when you are done, and FoxFlow sends those leads again while they are still within seven days. A corrected token also retries leads that failed because the previous token was rejected.

In Ads Manager, set the campaign's performance goal to Conversion Leads and choose the event named Converted.

FoxFlow sends Initial Lead when the lead arrives and Converted when it reaches the conversion step you set in Flow Settings → Steps. Leads that were already on the board before this was turned on are not reported, because Meta's lead id was not saved for them. FlowForm and other non-Meta leads are not part of this upload.

Disconnecting the Page also removes the saved token.

Troubleshooting

Leads aren't arriving. Check Lead Access Health. Then confirm forms are actually selected on the flow — not just the Page connected.

Leads arrive with no phone number. Your Facebook form isn't asking for one. FoxFlow can't text someone whose number you never collected, so add a phone field to the form.

A form vanished from the list. It was deleted or archived in Facebook. Pick a current one.

Names come through as "Anonymous". Facebook sends this when a lead has no name attached. {first_name} falls back to friend rather than sending something broken — see script variables.

Disconnecting

Disconnecting on the org Meta tab clears the Page connection, removes the conversion-reporting token, and removes form links from every flow. Leads already on your boards stay.

Common questions

Do I need Pro for Facebook Lead Ads?
No. Connecting a Page and receiving Lead Ads works on the Free plan, subject to the ten-visible-leads-per-flow limit.
Do Instagram leads work too?
Yes. Instagram lead forms run through the same Meta Lead Ads system, so they arrive the same way with no extra setup.
Why have my leads stopped arriving?
Almost always an expired Facebook permission. Check the Lead Access Health card in Organisation Settings under Meta. If it shows lead access lost, reconnect the Page.
Will I get leads that came in before I connected?
No. The connection starts a live feed from that moment. Older leads can be exported from Facebook and brought in with a CSV import.