How to Use the Meta Lead Ads Testing Tool (Facebook & Instagram)

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 in 2026, how test leads differ from real ones, how long delivery should take, what to do when the tool stops working, and the common error codes you’ll see in Track Status. It applies 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 to send test leads.
• Create Lead is the primary test path in 2026. Meta has disabled the Preview Form button with no ETA; see Tool Not Working? for the real-data workaround.
• Track Status shows webhook delivery within seconds, so use it to debug CRM integrations and identify the error code. Most integrations then deliver the lead within a few minutes.
• Test leads trigger the same webhook as live leads, so your CRM treats them identically, but they don’t count toward campaign results or ad spend.
• 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.

How Do You Use the Meta Lead Ads 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 from the dropdown. 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. Create a Lead: Click the Create Lead button and test lead form data will be sent through the form. Remember, only one test lead can exist per form at a time, so it’s crucial to test each form individually. Note that Create Lead sends generic placeholder data; some CRMs with strict field validation may reject it, in which case use the Ads Manager Test Form workaround to submit real values instead.

   A note on Preview Form: this button used to be the recommended way to test with real data, but Meta disabled it in 2026 with no ETA for restoration. If you don’t see it, that’s expected. See Preview Form button missing below.

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

6. Track Status: After a few seconds, click on “Track Status” to see if the lead has been successfully created. If it says pending, wait 10 seconds and click Track Status again. If you’re using LeadSync, you should see the following success message.

The LeadSync App ID will either be 1711149865783520 or 559339176323491

7. Check your Email, CRM or App: Make sure you’ve received the test data at the connection you’ve set up in LeadSync or Zapier.

Once Track Status shows success, it’s worth confirming the lead also landed on Meta’s side. Our guides to the Facebook Leads Center and checking your Facebook ad leads cover where to find lead records inside Meta’s own tools.

What’s the Difference Between a Test Lead and a Real Lead?

A test lead travels the exact same delivery path as a real lead: same webhook, same payload structure, same treatment by your CRM. The differences are in where it comes from and what it counts toward.

Because your CRM can’t tell the difference, a test lead will trigger any automations attached to new leads: welcome emails, sales notifications, autoresponders. Delete or tag test records in your CRM after a successful test so your sales team doesn’t chase a lead named “test”.

One caution on the “no ad spend, no campaign impact” point. That holds for the testing tool and for LeadSync’s built-in tester. It does not hold for submitting a form through a live ad’s preview link, which creates a real lead and distorts your campaign conversion data. More on that in the workaround section.

How Long Should a Test Lead Take to Arrive?

Short answer: seconds for Meta’s side, a few minutes end to end. Here’s the breakdown by stage:

If Track Status shows success but nothing has arrived after five minutes, the problem is downstream of Meta: check your field mapping, your spam folder, and whether your integration’s Facebook connection needs reconnecting. If Track Status shows failed, jump to the error code table below. And if Track Status never resolves at all, see the stuck on Pending fix.

This timing applies to test leads specifically. If test leads arrive fine but real campaign leads are going missing, that’s a different problem with different causes, usually permissions or an expired webhook subscription.

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 sends a test lead to the connection you’ve set up for that form, doing the same job as 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:

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.

Still not receiving the test lead?

If the tool itself is behaving but the test lead never shows up at the other end, run through this checklist before contacting LeadSync support:

1. The lead form you’re testing hasn’t been set up in your LeadSync account. Check that you’ve connected the correct lead form.
2. Your lead notification is sitting in your spam folder.
3. The email address you’re sending leads to is incorrect.

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.

Can You Create Test Leads via the API?

Yes. Developers can create a test lead by making a POST request to /{FORM_ID}/test_leads, provided there’s no existing test lead on the form and your Page role is Advertiser or above. If you’re building directly against Meta’s API, our Meta Lead Gen API guide covers webhooks, payloads, and setup in full.

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.

How long does a test lead take to arrive in my CRM?

Track Status in the testing tool usually updates within seconds. If it says pending, wait 10 seconds and check again. Once Track Status shows success, most sync tools and CRM integrations deliver the lead within a few minutes. If nothing has arrived after five minutes, check your field mapping, your spam folder, and whether the integration’s Facebook connection needs reconnecting.

Do test leads affect my campaign results or ad spend?

No. Test leads sent from the Lead Ads Testing Tool or from LeadSync aren’t attached to a campaign, so they don’t count toward campaign results and cost nothing. One warning: submitting a form via a live ad’s preview link creates a real lead and distorts campaign conversion data, so avoid that method.

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. Reassign the CRM under Business Settings > Integrations > 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.