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

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