Test Mode
Use Test Mode on suppliers to validate campaign setup before going live. Test leads flow through the full distribution path with is_test flag, excluded from billing and Meta CAPI.
Last updated:
What is Test Mode?
Test Mode is a supplier-level toggle that flags every lead from that supplier as is_test: true. Test leads flow through the full distribution path — campaign filters, buyer filters, delivery webhooks — but are excluded from billing, P&L reports, and Meta CAPI conversion events.
Use it to validate field mappings, webhook delivery, buyer routing, and automation rules before going live with real traffic — without polluting your revenue numbers or sending false conversion signals to Meta.
What Test Mode Does (and Doesn't)
| Behavior | Test Mode lead | Live lead |
|---|---|---|
| Goes through campaign filters | Yes | Yes |
| Routes to buyer per distribution method | Yes | Yes |
| Buyer's webhook fires | Yes (real POST) | Yes |
| Counts toward buyer's cap | No | Yes |
| Generates revenue in P&L | No | Yes |
| Generates cost in P&L | No | Yes |
| Fires Meta CAPI conversion event | No | Yes |
| Counts toward billing tier overage | No | Yes |
| Appears in dashboard reports | Yes (filtered to is_test=true) | Yes |
| Triggers buyer-side automations | Yes | Yes |
How to Enable Test Mode
- Go to the Supplier detail page.
- Toggle Test Mode to ON.
- Save. The change takes effect on the next ingested lead from this supplier.
- Every lead from this supplier now carries
is_test: truein its webhook payload — buyers can choose to filter these out on their side if they want.
When to Use Test Mode
- New supplier onboarding — validate the supplier's payload format, field mapping, and authentication before going live.
- New buyer integration — confirm webhook URL is reachable, field mapping lands correctly in the buyer's CRM, automations fire as expected.
- Schema changes — test a new custom field rollout before exposing it to production traffic.
- Distribution method changes — switch a campaign from Round Robin to Priority and verify the cascade works as expected.
- Compliance testing — confirm TCPA scrub rules catch the test phone numbers you've configured as known-litigators in a sandbox account.
Don't leave Test Mode on after onboarding — test leads still consume Lead Distro AI's processing capacity and bandwidth, just without generating revenue. Set a reminder to switch Test Mode off once the supplier is validated and ready for live traffic.
Frequently Asked Questions
Does Test Mode prevent leads from reaching buyers?
No — Test Mode leads flow through the full distribution path including the buyer's webhook. The point is to validate the entire path, including delivery. The buyer's system receives a real POST with
is_test: true in the payload; the buyer can choose to filter test leads out on their side or accept them for validation purposes. Some buyers prefer to see test leads land in a 'Sandbox' inbox; others ignore them.Are Test Mode leads counted in my plan's monthly lead volume?
No. Test Mode leads are excluded from billing-tier overage calculations. They consume Lead Distro AI's processing capacity but don't push you toward your plan's overage threshold. This is important for high-volume agencies running multi-supplier onboarding in parallel — test traffic can exceed normal daily volume without billing impact.
Do Test Mode leads fire Meta CAPI conversion events?
No. The CAPI integration explicitly excludes
is_test: true leads from sending conversion events to Meta. This prevents test traffic from polluting your Meta ad-optimization algorithm with false conversion signals — critical because Meta's algorithm learns from CAPI events; false positives would degrade ad performance for weeks.Can a buyer's automations fire on Test Mode leads?
Yes — automations on the buyer side fire on every lead.accepted event regardless of
is_test. This is intentional: you typically *want* to test that automations fire correctly during onboarding. If your buyer's automation has side effects (sends a real SMS to the lead, charges a payment), warn the buyer to handle is_test on their side or set up separate test endpoints.How do I see Test Mode leads in the dashboard?
Use the is_test filter in the dashboard. By default, dashboard reports include both live and test leads — toggle the filter to see only live, only test, or both. Most agencies default to live only for revenue reporting and switch to test only when debugging an onboarding pipeline.
Does Test Mode work with ping-post?
Yes. Test Mode pings go through the same eligibility checks as live pings — buyer availability, campaign filters, suppression — but the response is flagged
is_test: true. Buyers that opt into receiving test pings handle them as configured; buyers that ignore test pings see them as expected (no bid). The supplier sees the test ping response and can validate the ping-post flow end-to-end.Can I forget to turn Test Mode off and lose revenue?
Yes — that's the main risk. Test Mode is a manual toggle with no auto-expiry. Common pattern: set a calendar reminder for the supplier onboarding date you expect to go live; double-check Test Mode is off before declaring the supplier production-ready. Lead Distro AI shows a banner on the supplier detail page when Test Mode is active to reduce the risk of accidentally leaving it on.
Related Articles
Campaign Basics
Create and configure lead distribution campaigns in Lead Distro AI. Choose your routing method, set daily caps, map custom fields, and assign buyers with priority rules for every pipeline.
Field Mapping
Configure the data fields each lead carries in a Lead Distro AI campaign — system fields, custom fields, vertical-specific patterns, field transforms (Phone Formatter, Date Formatter), and validation.
Supplier Basics
Configure lead suppliers in Lead Distro AI: API key generation, cost-per-lead tracking, source attribution, ingestion endpoints, and supplier-level reporting for every traffic source.
If you have any questions, send us an email at support@leaddistro.ai