Connecting Meta Lead Ads (Facebook + Instagram)
Use OAuth to import Meta lead forms from Facebook and Instagram into LeadToSheet.
Before you start
You need admin access to the Facebook Page that runs your lead ads and the Meta business account it belongs to.
Note
While Meta App Review is pending, the OAuth flow is in closed beta. If you see a closed-beta message, use a Custom Webhook source until your account is enabled.
Connect your account
- 1
Open Sources
In LeadToSheet, open the site you want to receive the leads, then choose Sources in the sidebar.
- 2
Pick Meta Lead Ads
Click Connect on the Meta Lead Ads card. You will be redirected to Facebook to authorise.
- 3
Approve scopes
Meta asks for permission to read Pages and lead-form submissions. LeadToSheet does not post to your Page, read DMs, or manage your profile.
- 4
Pick Pages and forms
After redirect, choose the site, then select the Pages and lead forms you want to import. Each imported ad form becomes a Form in LeadToSheet.
- 5
Optional: backfill history
Enable backfill if you want recent historical leads pulled. AI scoring is off for backfills by default to avoid surprise enrichment cost.
How it works after setup
Meta sends a webhook when a new lead arrives. LeadToSheet uses your stored token to fetch the full lead from the Graph API, normalises the fields, and runs the same sheet sync, routing, AI scoring, and notification flow as website submissions.
Tip
Routes work the same way for imported Meta forms. For example, you can send hot Meta leads to Slack, HubSpot, or an auto-reply destination.
When the connection breaks
Meta tokens last about 60 days. LeadToSheet checks hourly and refreshes any connection with under 14 days remaining. There are two failure states you'll see a reconnect action for:
- TOKEN_EXPIRED — the refresh attempt failed (most commonly because the token aged out without an interactive Meta session to revive it).
- SCOPE_REVOKED — you (or another admin) removed LeadToSheet's access in Meta's Business Integrations settings. Reconnecting re-grants the leads_retrieval, ads_management, pages_manage_ads, pages_show_list, pages_read_engagement, and pages_manage_metadata scopes.
Important
While the connection is in either failure state, LeadToSheet cannot fetch the lead body from Meta. Reconnect quickly so new lead notifications do not arrive without usable field data.