Facebook leads are not arriving
Work through these in order. Each step is on Integrations → Lead sources → Meta Lead Ads.
1. Is the connection working?
Look at the Status card.
| Status | What to do |
|---|---|
| Connected | Go to step 2 |
| Token rejected | Create a new Page token and save it in step 1 of the page |
| Permission missing | Create the token again with leads_retrieval, pages_show_list, pages_read_engagement and pages_manage_metadata |
| Facebook unreachable | Facebook did not answer. Wait, then Save and verify. Do not replace a working token |
Also check Access token on the same card. If it says the token runs out soon, paste a new one before then.
2. Is the Meta app Live?
While your Meta app is in Development mode, Facebook only sends leads from people who have a role in the app. Real customers' leads are not sent at all. Switch the app to Live in the Meta developer dashboard.
3. Is instant delivery on?
Card 2. Instant delivery should say On. If it says Off — leads arrive every 15 minutes, it lists the reason. Leads still arrive within about 15 minutes while delivery is off.
Leads arrive only when you press Sync
Look at two lines on the Status card:
- Last pushed by Facebook says Never: Facebook is not sending leads to the CRM the moment they are submitted. The Meta app is almost always still in Development mode (step 2), or leadgen is not ticked under Webhooks → Page in the Meta app.
- Last checked with Facebook shows a warning: the CRM checks Facebook by itself every 15 minutes, and that check has stopped. That is a problem on the server, not in your workspace. Contact support.
When both are working, a lead appears within seconds of being submitted, and any lead Facebook fails to send is picked up within 15 minutes.
4. Did the lead arrive but fail?
Look at Recent leads from Meta. A row marked failed shows the reason under it. The most common reason is that the month's lead allowance on your plan is used up. See Cannot add a lead or a team member. After fixing the cause, open the form and use Reprocess earlier leads.
5. Arrived, but answers are in the notes
The lead arrived, but the form's questions are not mapped to fields yet. See Matching Facebook form questions to CRM fields, then reprocess to fill in earlier leads.
Still nothing
Send a lead with Meta's Lead Ads Testing Tool and note the time. If it does not appear within 20 minutes, contact support with that time and your Page ID. Do not send your token or app secret.