What it is
Common failures when setting up or running Facebook Lead Ads with Wtflo, and how to fix them.
Who does this
Platform owner for webhook/App Review issues. Tenants for form mapping and Page access.
Webhook verification failed
Symptom Fix
Meta shows "Verification failed" Confirm URL is https://<api>/webhook/facebook/leadgen/receive (includes /receive)
Token rejected Verify token in Admin → Facebook Lead must match Meta exactly
Timeout API must be publicly reachable; check SSL and firewall
404 Deploy latest API; route mounted at /webhook/facebook/leadgen
Test manually:
curl "https://<api>/webhook/facebook/leadgen/receive?hub.mode=subscribe&hub.verify_token=TOKEN&hub.challenge=12345"
Leads not creating contacts
Symptom Fix
Webhook fires but no contact Tenant must map form fields; unmapped leads stay pending
No webhook at all Page not subscribed — tenant clicks Subscribe in Lead Forms
Graph API error leads_retrieval not approved or token expired — reconnect Facebook
Wrong workspace Tenant connected wrong Page
Check API logs for [LeadGen Webhook] entries.
Permission errors
Error Fix
(#200) Requires leads_retrieval Partner: App Review + Live mode
(#10) Application does not have permission Re-request Advanced Access
User not Page admin Tenant needs Page admin role in Meta
Signature / security
Wtflo validates incoming webhook payloads. If Meta rotates app secret, update App Secret in Admin → WhatsApp immediately.
Test procedure
Meta Webhooks → Page → leadgen → Test event.
Ads Manager → Lead form → Create test lead.
Confirm API log + contact in tenant CRM.
Related
Lead Ads partner setup
Meta Leadgen webhook setup
Common Meta errors