How do I test my Facebook lead form?
Use Meta's Lead Ads Testing Tool on Meta for Developers. Pick your Page and form, click Create Lead to create a lead with dummy data, then click Track Status to see whether the real-time update to your endpoint succeeded or failed. You can create one test lead per form, so delete it before making another.
Testing a lead form answers one question before you spend money: when a real person submits, does the lead land where your team will see it? Meta’s Lead Ads Testing Tool, at developers.facebook.com/tools/lead-ads-testing, creates a test lead on your form and fires a real-time update to your endpoint. You can then watch whether the hand-off to your CRM or webhook succeeds or fails.
What do you need before testing?
- An instant form created under your Page.
- A Page role of Advertiser or above on the Page where the form was created, which Meta’s developer guide requires. Meta’s guide also says, in its own words, “you cannot use the tool in developer mode.”
How do you send a test lead?
- Open the Lead Ads Testing Tool and select your Page from the dropdown.
- Select the form in the Form dropdown.
- Click Create Lead. By default the lead contains dummy data.
- To send your own values instead, click Preview Form and customise the data.
- Once the lead exists, click Track Status.
- Read the status: it shows pending for a few seconds, then success or failed.
- If it failed, check the error_code column for the reason.
How do you run a second test?
You can create only one test lead per form. To test again, click Delete Lead, then create a new one. Meta’s guide says only the owner of a lead can delete it.
Which failure cause does Meta document?
Meta documents one cause in Leads Access. Once someone with full control of the business portfolio customizes Leads Access, new CRMs don’t get lead permission until it’s assigned. A CRM without access receives no real-time updates, and Meta says you’ll see an error message for that CRM in the Lead Ads Testing Tool. Assign the CRM in Leads Access and test again.
Can you check how the form looks without the tool?
Yes. When you build a form in Meta Business Suite, click the arrows at the top of the form preview to step through each section before publishing.
FAQ
Do test leads count in my Ads Manager results?
No. Meta says a lead you submit while testing your ad appears in the file you can download, but isn’t counted in the Results column in Ads Manager. Setting your form’s sharing to Restricted doesn’t keep these test leads out of the download.
Why do some leads have no ad ID in the download?
Meta lists three possible reasons a downloaded file has no ad ID or ad set ID field: the lead was generated through organic reach, it was submitted through an ad preview, or you don’t have advertiser privileges on the ad account that created the lead ad campaign.
Can I create a test lead through the API instead?
Yes. Meta’s developer guide says you can make a POST request to /{FORM_ID}/test_leads with the Page access token. The form must have no existing test lead, and you need a Page role of Advertiser or above. The field_data parameter lets you send your own answers.
Sources
- Testing and Troubleshooting (Lead Ads, Marketing API) (Meta, checked 2 Oct 2026)
- About organic leads (Meta, checked 2 Oct 2026)
- Enable Leads Access in Meta Business Suite (Meta, checked 2 Oct 2026)
- Create a lead ad with instant form from Meta Business Suite (Meta, checked 2 Oct 2026)
- Download or retrieve your leads data from Meta (Meta, checked 2 Oct 2026)
Drafted with AI and checked claim by claim against the pages linked under Sources. Found a mistake? Tell us via the corrections policy.