How to use the Facebook Lead Testing Tool

The Meta Lead Ads Testing Tool is a free developer tool at developers.facebook.com/tools/lead-ads-testing that lets you send fake leads through your live Facebook and Instagram lead forms to verify that webhooks, CRM connections, and email notifications are firing correctly, without spending ad budget. You need admin or advertiser access on the connected Page to use it.

This guide walks through how to use the tool, what to do when it stops working, and the common error codes you’ll see in Track Status, whether you’re using LeadSync, Zapier, Make, or a direct CRM integration.

Key takeaways

• The tool lives at developers.facebook.com/tools/lead-ads-testing and is free; only one test lead can be submitted per form at a time.
• You need Page admin or advertiser access. Lead Access alone is not enough for the Preview Form button.
• Track Status shows real-time webhook delivery, so use it to debug CRM integrations and identify the error code.
• If the tool shows “Something went wrong” or the Preview button is missing, see Tool Not Working? below for current workarounds.
• Test leads trigger the same webhook as live leads, so your CRM treats them identically.
• If you use LeadSync, the ⋯ menu on each form has its own Send Test Lead and Delete Test Lead buttons, so you can test and clear test leads without opening Meta’s tool.

Step-by-Step Guide to Using the Facebook Lead Ad Testing Tool

Basic Steps

1. Navigate to the Testing Tool: Go to Facebook’s Lead Ads Testing Tool.
2. Select Your Page: Choose the relevant Facebook Page and Form from the dropdown menus. Facebook will automatically show you if you have permissions to access leads, if you have Lead Access Manager enabled, and if you are a Page Admin. Under this section you’ll also be able to see which Applications have access to your leads. If you’re using LeadSync, make sure this is showing with a tick. If you’re seeing an orange warning icon, click on the arrow on the right for more details about the issue.

3. Select Your Form: From the dropdown, select the form that you want to test, making sure that this is the same form you have setup in the integration tool you’re using AND the same form you’re using in your Meta Ads.

4. Preview your Form: the best way to test your form is to use the Preview Form option. This lets you fill in the form details with real data. Some CRMs reject the generic placeholder data sent by the Create Lead button, so previewing with real values gives you a more reliable test.

5. Create a Lead: If you don’t want to submit your own details, via the preview form option, just click the ‘Create lead’ button to proceed and test lead form data will be sent. Remember, only ‘one lead’ can be submitted per form at a time, so it’s crucial to test each form individually.

6. Test Lead Sent: You should now see “Your test lead has been sent” message.

7. Track Status: After a few seconds, click on “Track Status” to see if the lead has been successfully created. If you’re using LeadSync, you should see the following success message.

The LeadSync App ID will either be 1711149865783520 or 559339176323491

8. Check your Email, CRM or APP: Make sure you’ve received the test data to the connection you’ve setup in LeadSync or Zapier.

Advanced Features

• Preview Form: Before submitting, you can preview the form to customize the data being sent.
• Error Handling: If you encounter a 103 error, it means CRM access has been revoked. You’ll need to reset the Facebook Leads Access CRM permissions.

Send and Delete Test Leads Inside LeadSync

If your forms are connected through LeadSync, you don’t have to open Meta’s testing tool every time you want to test. Each form in your Lead Forms list has a ⋯ menu with two test actions:

• Send Test Lead pushes a test lead through your live form and queues it through your LeadSync connection, just like Meta’s Create Lead button. Use it to confirm your CRM, email notification, or webhook receives the lead.
• Delete Test Lead clears the form’s existing test lead so you can send a fresh one. Facebook only allows one test lead per form at a time, so this saves you a trip back to the testing tool whenever a previous test is in the way.

One Facebook rule still applies: a test lead can only be deleted by whoever created it. If the current test lead was created inside Meta’s own Lead Ads Testing Tool, LeadSync cannot remove it for you. In that case the Delete Test Lead button tells you so and points you to the testing tool with the exact steps to clear it there.

Tool Not Working? Common Errors and Fixes

Meta’s testing tool has been intermittently broken throughout 2026: blank screens, vanished Preview buttons, and “Something went wrong” errors. Here’s what users on r/PPC, r/FacebookAds, and r/zapier have actually confirmed works in the past few months. If none of the fixes below resolve your issue, Workaround: Use Ads Manager’s Test Form feature at the bottom is the reliable fallback.

“Something went wrong. Please try again later.”

This error became widespread in 2026 and appears intermittently, and multiple users report it resolving on its own without any changes on their end, which strongly suggests it’s a Meta backend issue rather than a configuration problem.

Things to try first, in order:

1. Clear cookies for developers.facebook.com and facebook.com, then sign back in. This is the most commonly reported fix in r/PPC and r/zapier threads.
2. Try Chrome incognito or a different browser to rule out a corrupted session.
3. Verify your Business Manager account if the tool prompts you. Some users report being asked to re-verify when the error first appears.

If none of the above works, treat it as a Meta-side outage and use the Workaround below.

Preview Form button missing

In 2026 Meta confirmed via support escalation that the Preview Form feature has been temporarily disabled “as we work on enhancements”, with no ETA for restoration. This is happening on Meta’s side regardless of your Page configuration, permissions, or form status, so the usual checks (Page admin role, form not archived, creative attached) won’t bring it back.

Meta’s suggested replacement is the Create Lead button, but that only sends generic dummy data, so you can’t fill out the form with real values that way. For real-data testing, use the Workaround below.

Track Status shows “failed” with code 100, 103, or 190

These are token or permission errors, not tool bugs:

• Code 100, subcode 33. You’re using a Page token to test an ad-level integration. Switch to a Business System User token.
• Code 103. CRM access has been revoked. Reset Lead Access permissions for the integration app under Page Settings > Lead Access.
• Code 190. Your CRM’s connection token has expired. Reconnect the integration in your CRM’s Facebook settings.

LeadSync customers can reconnect their Facebook account from their account connections page, or contact LeadSync support to have a token verified directly.

Test lead stuck on “Pending” status

This is a known issue in 2026: some test submissions never resolve to “success” or “failed”. The reliable fix:

1. In the Lead Ads Testing Tool, select the same Page and Form.
2. Click Delete Lead to clear the pending submission.
3. Submit a fresh test via the Workaround below.

Form dropdown is empty after selecting a Page

If no forms appear after picking your Page, the usual causes are:

1. The Page genuinely has no published lead forms yet (check Forms Library in Meta Business Suite).
2. Your account doesn’t have Lead Access for the Page (Business Settings > Integrations > Lead Access).
3. The API call returned stale data, so switch to a different Page in the dropdown and back to force a refresh.

Workaround: Use Ads Manager’s Test Form feature

When the testing tool is broken (Preview button missing, page won’t load, or tests stuck on Pending), this sequence is the verified workaround that has been reported working repeatedly in 2026:

1. Open Ads Manager and select the Page connected to your form.
2. Navigate to All Tools > Instant Forms.
3. Find your form in the list and click Test Form.
4. Fill out the form with real test data. The submission triggers webhooks identically to a live lead, so your CRM, email integration, or Zap will receive it.
5. Return to the Lead Ads Testing Tool, select the same Page and Form, and click Delete Lead to clear the test submission so the form remains testable again.

Some users have warned that submitting via a live ad’s dark-post preview link (an older workaround) is risky because it counts as an actual lead and distorts campaign conversion data. The Instant Forms > Test Form path above avoids that.

Troubleshooting Common Issues

Debugging Real-Time Update Integration

If you’re facing issues with your integration with Facebook’s Webhooks, here’s how to debug:

1. Use the tool to create a test lead.
2. Check the status of the lead. If it’s pending, wait a few seconds and check again.
3. Once the lead is pushed to your endpoint, the status should change to “success” or “failed,” providing insights into what might be going wrong.

API Interactions

For those who prefer a more technical approach, you can create a test lead by making a POST request to /{FORM_ID}/test_leads. Make sure you meet the following requirements:

• No existing test leads for the specified Lead Ad form.
• A page role of Advertiser or above on the page under which the form was created.

Other Common Reasons Why You Might Not be Receiving Leads

1. The lead form you’re using in your lead ad hasn’t been set up in your LeadSync Account. Please check to make sure you’ve connected the correct lead form in your LeadSync account.
2. You lead notification is sitting in your spam folder.
3. The email address you’re sending leads to is incorrect.

Please be sure to check these before contacting LeadSync support.

Frequently Asked Questions

How do I access the Meta Lead Ads Testing Tool?

Go to developers.facebook.com/tools/lead-ads-testing in your browser. You must be logged into Facebook with an account that has admin or advertiser access to the Page connected to your lead ad forms.

Why aren’t my test leads showing up in my CRM?

Common reasons include: 1) Your integration tool doesn’t have permission to access leads from your Page. Check the Facebook Business Settings > Integrations section. 2) You selected the wrong form in the testing tool. 3) Your CRM field mapping is misconfigured. 4) The webhook subscription has expired and needs to be reconnected.

Can I test Instagram Lead Ads with the testing tool?

Yes. The Meta Lead Ads Testing Tool works for both Facebook and Instagram lead ad forms. Select the Facebook Page linked to your Instagram account, then choose the form you want to test. Instagram lead forms appear in the same dropdown as Facebook forms.

How many test leads can I send?

You can send as many test leads as needed. There is no limit. Test leads are free and don’t count toward any ad spend. However, only one test lead can be submitted per form at a time.

How do I delete a Facebook test lead?

Facebook allows only one test lead per form, and it can only be deleted by whoever created it. In Meta’s Lead Ads Testing Tool, select the same Page and Form and click Delete Lead. If your forms are connected through LeadSync, open the three-dot menu on the form in your Lead Forms list and click Delete Test Lead to clear it without opening the testing tool. A test lead created inside Meta’s tool can only be removed from that same tool.

What is the difference between the testing tool and a form preview?

The Lead Ads Testing Tool sends a real webhook notification to all connected apps, exactly like a live lead submission. A form preview in Ads Manager only shows you what the form looks like. It does not trigger webhook delivery to your CRM or integration tools. Always use the testing tool to verify your integration is working end-to-end.

Why am I not receiving leads from Facebook?

Common reasons include: the lead form hasn’t been set up in your integration account, notifications are in your spam folder, incorrect email address configuration, or permissions issues with your Facebook Page. Use the testing tool to send a test lead and check the Track Status results.

The Meta Lead Ads Testing Tool shows “Something went wrong”. How do I fix it?

Clear cookies for developers.facebook.com and facebook.com, then sign back in. This is the most commonly reported fix on Reddit. If that doesn’t work, try Chrome incognito or a different browser. Multiple users in 2026 have reported the error resolving on its own, suggesting it’s often a Meta backend issue rather than a problem with your account. While you wait it out, you can test forms via Ads Manager > All Tools > Instant Forms > Test Form.

Why is the Preview Form button missing from the Lead Ads Testing Tool?

Meta has temporarily disabled the Preview Form feature “as we work on enhancements,” according to a Meta Support response shared in r/FacebookAds in 2026. There is no ETA for restoration and the missing button is unrelated to your Page configuration, permissions, or form status. To test with real form data, use Ads Manager > Select Page > All Tools > Instant Forms > Test Form, then delete the resulting lead from the Testing Tool afterwards.

What do error codes 100, 103, and 190 mean in Track Status?

Code 100 (subcode 33) means you’re using a Page token to test an ad-level integration. Switch to a Business System User token. Code 103 means CRM access has been revoked. Reset Lead Access permissions for the integration app under Page Settings > Lead Access. Code 190 means your CRM’s connection token has expired. Reconnect the integration.

Next Steps

Once you’ve confirmed your test leads are coming through, here are some useful resources to help you get the most out of your lead ad campaigns:

• Run a form split test: Now that your integration is verified, see how to split test Meta lead forms without losing leads. Meta’s new Form testing feature creates up to 5 new forms with new form IDs, and the routing implications are exactly what this tool helps you debug.
• Improve your targeting: Use our complete Facebook & Meta Ads targeting guide to find the right audience for your campaigns.
• Stay compliant: Generate a free privacy policy for your lead ads, required by Meta for all lead forms.
• Target high-value leads: Learn 12 ways to target high net worth individuals on Facebook & Instagram.
• Get instant lead notifications: Learn how to send Facebook leads to email so you receive every lead in your inbox the moment it comes in.
• Connect to your CRM: See our complete integration guide for connecting your lead ads to Mailchimp, HubSpot, ActiveCampaign, and 20+ other tools.