Supplier Basics

Q: What's the difference between Fixed, Variable, and Revenue Share supplier cost modes?

Fixed sets a flat cost per lead (e.g., $25/lead) — set once, applied to all leads from this supplier. Variable (Meta Ads) calculates cost from actual synced Meta ad spend — requires Meta integration and per-supplier pixel wiring. Revenue Share pays the supplier a percentage of whatever the buyer pays — especially powerful with ping-post since bid prices vary per lead. Revenue Share works with all campaign types, not just ping-post.

Q: How do I set lead caps on a supplier?

Each supplier supports cap windows: daily, weekly, monthly, and total lead counts, plus dollar budget caps on the same windows. When any cap is hit, that supplier is automatically paused until the corresponding window resets. There are also ping caps specifically for V2 ping-post campaigns — counted at the ping step, before any lead is posted, so a noisy supplier doesn't exhaust its quota on pings that never convert to posts.

Q: Can I clamp the price a supplier can receive on a ping?

Yes — set a Sell Price Range (Min and Max) on the supplier. If the winning buyer bid falls outside the range, Lead Distro AI rejects the ping instead of quoting it to the supplier. Use Min to avoid selling leads below your cost floor; use Max to prevent runaway pricing from a single high-bid buyer dominating one supplier's traffic. (The legacy Bid Threshold setting was retired in May 2026 — use Min Sell Price instead; it's the same logic, cleaner UI.)

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.

Last updated: May 22, 2026

What is a Supplier?

A supplier represents a lead source — your own advertising, a lead vendor, a form on your website, or any system that generates leads. Each supplier gets a unique API key for authenticating lead submissions.

Cost Tracking

Track costs per supplier to calculate your true blended cost per lead and profit margins.

Cost Mode	How It Works
Fixed	A fixed cost per lead (e.g., $25/lead). Set once and it applies to all leads from this supplier.
Variable (Meta Ads)	Cost is calculated from actual Meta ad spend synced automatically. Requires Meta integration.

API Key

Each supplier gets an API key generated automatically when created. Use this key in the x-api-key header when sending leads to the ingest API.

Keep your API keys secure. If a key is compromised, delete the supplier and create a new one to generate a fresh key.

Frequently Asked Questions

What's the difference between Fixed, Variable, and Revenue Share supplier cost modes?

Fixed sets a flat cost per lead (e.g., $25/lead) — set once, applied to all leads from this supplier. Variable (Meta Ads) calculates cost from actual synced Meta ad spend — requires Meta integration and per-supplier pixel wiring. Revenue Share pays the supplier a percentage of whatever the buyer pays — especially powerful with ping-post since bid prices vary per lead. Revenue Share works with all campaign types, not just ping-post.

How do I set lead caps on a supplier?

Each supplier supports cap windows: daily, weekly, monthly, and total lead counts, plus dollar budget caps on the same windows. When any cap is hit, that supplier is automatically paused until the corresponding window resets. There are also ping caps specifically for V2 ping-post campaigns — counted at the ping step, before any lead is posted, so a noisy supplier doesn't exhaust its quota on pings that never convert to posts.

Can I clamp the price a supplier can receive on a ping?

Yes — set a Sell Price Range (Min and Max) on the supplier. If the winning buyer bid falls outside the range, Lead Distro AI rejects the ping instead of quoting it to the supplier. Use Min to avoid selling leads below your cost floor; use Max to prevent runaway pricing from a single high-bid buyer dominating one supplier's traffic. (The legacy Bid Threshold setting was retired in May 2026 — use Min Sell Price instead; it's the same logic, cleaner UI.)

What's Max Sells Per Lead?

Set the maximum number of buyers a single lead can be sold to. Set to 1 for exclusive distribution (the highest bidder gets the lead, exclusively). Set to 2-5 to share the lead with the top N bidders — useful in non-exclusive verticals like home services where multiple contractors quote the same homeowner. Lead Distro AI picks the winners by bid at ping time, so suppliers send a single post and the system handles fan-out.

How does Test Mode work on suppliers?

Toggle Test Mode on a supplier and every lead it sends is flagged is_test: true — distributed normally to all configured buyers and triggering full delivery (so you can confirm webhook payloads land correctly), but excluded from billing, P&L reports, and Meta CAPI conversion events. The buyer-side activation means delivery URLs actually receive test payloads, not just the in-app log. Switch off Test Mode when you're ready to count real revenue.

Can I wire each supplier to its own Meta pixel?

Yes. Per-supplier Meta pixel wiring lets you isolate CAPI conversion events per traffic source — Supplier A's lead conversions report against Pixel A, Supplier B against Pixel B. This is critical when running attribution for multiple ad accounts or clients on the same campaign infrastructure. Configure in the supplier's Meta Integration tab.

What is the Supplier Portal?

A self-serve portal for suppliers (separate from the buyer-facing Buyer Portal). Suppliers can view ingestion logs, see their own cost-tracking and payout numbers, access their API Specs page with copy-paste curl examples, and (with the right permissions) manage their own caps and integration settings. Useful when working with external lead vendors who need visibility without seeing your buyer-side margin.

Supplier Cost Modes

Lead Distro AI supplier cost modes: Fixed, Variable (Meta Ads), and Revenue Share. How each calculates per-lead cost, when to use which, and FAQs for accurate profit tracking.

Supplier API Key Setup

Generate, rotate, and secure Lead Distro AI supplier API keys. Authentication header format, key compromise recovery, IP allowlisting, and FAQs.

Supplier Caps

Cap supplier lead volume and dollar spend per day, week, month, or total in Lead Distro AI. Ping caps, price-range clamps, and runaway-supplier protection.

Per-Supplier Meta Pixel Wiring

Wire each Lead Distro AI supplier to its own Meta pixel for isolated CAPI conversion attribution. Multi-tenant agency pattern, setup steps, and FAQs.

If you have any questions, send us an email at support@leaddistro.ai

Buyer Basics Automation Basics