Facebook Leads Integration
Section: Integrations & AI
URL:/admin/facebookleadsintegration
Page title: Facebook Leads Integration
Overview
The Facebook Leads Integration receives leads from Facebook Lead Ads via webhook and automatically creates CRM lead records. When a prospect fills out a Facebook instant form, their data flows directly into your CRM pipeline in real time — no manual export required.
Business value
Closes the gap between paid social advertising and CRM follow-up. Leads arrive in the CRM within seconds of a Facebook form submission, giving sales reps the fastest possible follow-up window.
- Who uses it: Marketing, sales, SDRs
- Key benefit: Reduce lead follow-up time from hours (manual CSV export) to seconds (real-time webhook), which directly improves contact rate and conversion.
- Metrics it influences: Lead response time, lead-to-contact rate, cost per qualified lead from Facebook
Typical use cases:
- Run a Facebook Lead Ad campaign; every submission creates a CRM lead instantly with source tagged as "Facebook Lead Ad"
- Map Facebook form fields (name, email, phone, company) to the corresponding CRM lead fields
- Route Facebook leads to a specific pipeline stage or assigned rep based on the campaign
Accessing this module
From the admin sidebar, navigate to Facebook Leads, or open the URL directly:
/admin/facebookleadsintegration
Setup overview
- Configure the integration — enter your Facebook App ID, App Secret, and Page Access Token.
- Register the webhook URL — copy the CRM webhook endpoint and add it as a subscribed webhook in your Facebook App settings. The endpoint is excluded from CSRF verification to allow Facebook delivery.
- Map form fields — match Facebook Lead Ad form field names to CRM lead fields.
- Test with a lead — submit a test lead from Facebook to confirm the CRM record is created correctly.
- Monitor incoming leads — new leads appear in the CRM Leads list with source "Facebook Lead Ad".
Map all Facebook form fields to CRM fields during setup and verify with a test lead before launching a campaign — unmapped fields are silently discarded, so a missing field mapping means lost prospect data at scale.
The webhook URL is excluded from CSRF verification by design to allow Facebook delivery. Keep your Facebook App Secret strictly confidential — anyone who knows it can forge lead submissions to your CRM.
Field mapping
Facebook form fields are mapped to CRM fields during setup. Common mappings:
| Facebook field | CRM lead field |
|---|---|
full_name |
Name |
email |
|
phone_number |
Phone |
company_name |
Company |
| Custom fields | Mapped to CRM custom fields |
Source: crm-connect-main/app/modules/facebookleadsintegration