Lead Distro AILead Distro AI
Back to blog
Meta CAPI IntegrationMeta CAPIFacebook Conversions APILead Distro AILead Distribution

Lead Distro AI Meta CAPI Integration: Setup, Events, and Per-Supplier Pixel Wiring

How the Lead Distro AI Meta CAPI integration works: multi-pixel support, server-side event types, deduplication with the browser pixel, and a 5-minute setup.

Rafael Hernandez

Rafael Hernandez

Founder & CEO

Ex-Microsoft SWE · $10M+ PPL ad spend

19 min read
Rafael Hernandez

I hope you enjoy reading this blog post. If you want to try Lead Distro AI for free, click here.

Author: Rafael Hernandez | Founder & CEO of Lead Distro AI

Last Updated: October 26, 2026

What the Lead Distro AI Meta CAPI integration does

The Lead Distro AI meta capi integration is a native, server-side connection to Meta's Conversions API that fires lead-quality events back to Facebook and Instagram from inside the platform, without code, without a Zap, and without a separate server. When a lead lands in Lead Distro AI, the platform sends a Lead event to Meta server-side using the supplier's mapped Pixel ID and access token. When that lead is accepted by a buyer, redistributed, or marked converted, additional events fire to the same pixel. Every event is hashed for PII compliance, carries a stable event_id so retries never double-count, and is visible in a per-lead CAPI Event column with a one-click Retry button if Meta returns an error.

In short: if you're running Meta lead ads through Lead Distro AI, the meta capi integration is already in the box. You connect one or more Meta Pixels under Settings, wire each campaign or supplier to a pixel, and the platform handles the server-side event delivery, deduplication, retries, and per-pixel event logs. No engineer required.

Using a Lead Distro AI funnel? Set up Meta on the funnel itself instead: open the funnel, go to the Integrations tab, and click the Meta card. That card fires the Meta Pixel in the visitor's browser and sends the Conversions API event from our server, with one shared event_id, so Meta counts each lead once and matches more of them. The Settings setup described below sends server events only.

Key Takeaways

  • Lead Distro AI supports multiple Meta CAPI integrations per organization, so each supplier or ad account can fire to its own dedicated Meta Pixel.
  • Server-side events use hashed email and phone plus the captured fbclid to match conversions back to the original ad click, recovering attribution iOS 14.5+ broke.
  • Funnel leads get browser and server events from the funnel's own Meta card. It fires the pixel and the server-side meta capi event with a shared event_id, so Meta counts each lead once. The Settings integration is server-only, for leads that arrive by API and for later outcomes like accepted or converted.
  • The CAPI Event column on the Leads page shows Sent or Not sent per lead, with hover-to-see error details and a one-click Retry button that Meta safely dedupes.
  • Setup is under five minutes: add a Pixel ID and access token in Settings > Integrations, assign the pixel to a campaign, and the next inbound lead fires the first server-side meta capi event.

Funnel Meta card or Settings integration: which one to use

Lead Distro AI has two places to connect Meta, and they do different jobs.

Funnel > Integrations > Meta cardSettings > Integrations > Meta Conversions API
Browser pixel (PageView and Lead in the visitor's browser)YesNo
Server-side Conversions API eventYes, at submit, same event_id as the pixelYes, when a lead comes in, is accepted, converts, or is rejected
Best forAny ad traffic sent to a Lead Distro AI funnelLeads that arrive by API or from other forms, and later outcomes

If your leads come from a Lead Distro AI funnel, start with the funnel's Meta card. You can add the Settings integration on top to report later outcomes (a buyer accepting the lead, a sale). You do not have to worry about counting a lead twice: when both send the same event name to the same pixel, Lead Distro AI skips the Settings copy for that funnel's leads. To send a later outcome as well, give it its own event name, for example Lead from the funnel and LeadAccepted from Settings.

Why the Meta Conversions API matters for lead generation

The facebook conversions api, now branded the meta conversions api, exists because the browser pixel cannot see what happens to a lead after the form fill. Apple's App Tracking Transparency rollout in iOS 14.5 cut Meta's signal loss to roughly 15 percent of mobile traffic, according to AppsFlyer's 2024 attribution benchmark report (AppsFlyer, 2024). For pay-per-lead operators that gap is even more painful, because the highest-value signal is not the form submission, it is the buyer-accepted lead or the converted lead 24 hours later. The meta capi is how you send those downstream signals server-side, so Meta can stop optimizing for cheap form-fills and start optimizing for revenue-generating leads.

Meta's own data shows advertisers running CAPI alongside the Pixel see an average 13 percent lower cost per action (Meta Business Help Center, 2025). For a pay-per-lead agency spending $40,000 a month on Meta, that delta is roughly $5,200 in monthly waste recovered. The deeper context on why this loop matters, what events to send, and how to think about the full feedback chain lives in the Meta Conversions API for lead generation guide; this page is the implementation reference for doing it inside Lead Distro AI.

How the integration is architected

The Lead Distro AI meta capi integration is built around three primitives: the integration record, the pixel-to-campaign mapping, and the event log. The integration record holds the Pixel ID, the long-lived access token, and the event mapping table. The mapping decides which campaigns or suppliers fire to which pixel, so a multi-pixel agency does not mix ad-account signals. The event log is per-integration, so when you have to debug a 400 error from Meta, you are looking at one pixel's history, not a shared firehose.

When a lead is ingested, the platform looks up the campaign's assigned meta capi integration. If one is wired, it builds the server event payload, hashes the email, phone, first name, and last name with SHA-256, attaches the captured fbclid as fbc, generates a deterministic event_id from the lead UUID, and POSTs to graph.facebook.com/v18.0/{pixel_id}/events. These events are server-only. Browser-side pixel events, and their matching to the server event, come from the funnel's own Meta card (see the section above).

Event types the platform sends

EventWhen it firesMatch keys
LeadInbound lead is accepted into Lead Distro AIfbc, hashed email, hashed phone
LeadAccepted (custom)A buyer marks the lead as accepted in the buyer portalfbc, hashed email, hashed phone, lead_id
LeadConverted (custom)A buyer marks the lead as sold or convertedfbc, hashed email, hashed phone, lead_id, value, currency
PurchaseA value is attached on conversion (sold deal)fbc, hashed email, hashed phone, value, currency

The standard Lead event is what Meta's bidding model has been trained on for years, so it is included by default. The two custom events, LeadAccepted and LeadConverted, are the optimization signal that actually teaches the algorithm to find people who buy from your buyers, not just people who fill out forms. Meta supports custom events in the same Standard Events framework, so they appear in the Events Manager UI for the pixel alongside Lead and Purchase.

Multi-pixel support and per-supplier wiring

A meaningful share of Lead Distro AI customers run a brokerage model with several suppliers, each on their own ad account, each with their own pixel. The meta capi integration supports this directly: you can add as many meta capi integrations as you have pixels under Settings > Integrations, each with its own Pixel ID, access token, and event mapping. From the campaign Settings tab you pick which pixel fires for that campaign, and from the Sources cell on the campaign you can wire a specific pixel to a specific supplier, so each supplier's conversions land on their own ad account's pixel.

The Meta CAPI popover on the supplier card surfaces the integrations already wired to the current campaign at the top, with green per-supplier counts and toggles, so you can see at a glance which sources are tracking conversions and which are firing into a void. A Pixel badge appears on the supplier card whenever a dedicated pixel is wired, which makes onboarding audits fast. This is the same surface where you fix the most common multi-supplier setup mistake, which is leaving a new supplier on the default pixel and routing leads to an ad account that never gets the signal back.

CAPI Event column, retries, and event logs

Every lead row on the Leads page has a CAPI Event column showing Sent or Not sent for that lead. Hover and you get the reason: not_configured, invalid_access_token, pixel_not_found, network_error, or a verbatim 400 response from Meta. Any Not sent row gets a one-click Retry button that re-fires the server event. Meta dedupes re-sends by event_id, so retrying after you fix the access token is safe and will not double-count a conversion. For debugging at the integration level, each meta capi integration has its own event log under Settings > Integrations, so you can troubleshoot pixel by pixel without sorting through a shared timeline.

This visibility is the part of the loop most homegrown CAPI implementations skip. A lead that should have fired a LeadAccepted event but did not is usually invisible until your Facebook ad spend creeps up and the buyer starts asking why lead quality dropped. With the CAPI Event column you find that gap in 30 seconds instead of three weeks.

5-minute setup walkthrough

The setup flow is intentionally short because most agency owners are not Meta technical specialists. Start your free trial and you can wire the full integration in an afternoon, no developer required, by following these steps. Create an account and skip to step two if you already have a campaign live.

Step 1: Get your Pixel ID and access token from Meta

In Meta Events Manager, pick the pixel you want to use, click Settings, and scroll to Conversions API. Generate a system user access token under Business Settings > System Users; this is the long-lived token Lead Distro AI uses to fire server-side events. The Pixel ID is the 15- or 16-digit number at the top of the pixel's Events Manager page. Hashing happens server-side inside Lead Distro AI, so you do not need to enable any extra options on the Meta side.

Step 2: Add the integration in Lead Distro AI

If your leads come from a Lead Distro AI funnel, do this on the funnel instead: open it, go to Integrations, click the Meta card, and paste the same Pixel ID and access token. Otherwise, in the Lead Distro AI app, go to Settings > Integrations, click Add Meta CAPI integration, paste the Pixel ID and access token, name the integration so you recognize it in a list ("Acme Solar pixel" beats "Pixel 1"), and save. The platform validates the credentials against Meta on save, so if the token is wrong you find out immediately, not at 2 a.m. when an event fails.

Step 3: Wire the integration to a campaign or supplier

Open the campaign you want this pixel to fire on, go to Settings, and select the Meta CAPI integration from the dropdown. For multi-supplier campaigns, open the Sources cell on the campaign Performance page and assign the integration to specific suppliers; only the assigned supplier's leads fire to that pixel. The Meta CAPI popover shows you per-supplier toggles, so you can confirm wiring without leaving the page.

Step 4: Send a test lead and confirm in the CAPI Event column

Submit a test lead through the campaign's form or webhook. Within a few seconds the lead appears on the Leads page with a green Sent badge in the CAPI Event column. Hover to confirm the event type (Lead), the pixel it fired to, and the event_id. In Meta Events Manager, the same event should appear under the pixel's Test Events tab within roughly 30 seconds. If it does not, hit Retry on the lead row and check the event log under Settings > Integrations.

Lead Distro AI Meta CAPI vs hand-rolled implementations

Lead Distro AI Meta CAPICustom server-side build
Setup time5 minutes20-40 engineering hours
Multi-pixel supportYes, nativeCustom code per pixel
Browser pixel dedupAutomatic on funnel leads, via the funnel's Meta cardManual event_id plumbing
Per-lead Sent/Not sent visibilityYes, in CAPI Event columnBuild your own dashboard
Retry on failed eventsOne-click Retry buttonCustom queue and worker
Per-pixel event logsYes, nativeCustom logging
Hashed PIISHA-256, automaticYou implement and test
Maintenance when Meta updates the APIIncludedYour engineer

According to the 2025 State of B2B Lead Generation Report from Demand Gen Report, 64 percent of B2B marketers say they cannot fully attribute lead-source ROI (Demand Gen Report, 2025). Hand-rolling a Meta CAPI build is a real cost, and most lead-gen teams never get past Lead because the engineering keeps slipping. The integration inside Lead Distro AI is the shortest path between "Meta is wasting spend on bad leads" and "Meta is bidding on people who actually buy."

"For pay-per-lead and pay-per-call agencies, the CAPI integration is not a nice-to-have, it is the single highest-leverage piece of attribution infrastructure you can install," says Rafael Hernandez, Founder and CEO of Great Marketing AI and the team behind Lead Distro AI. "If you are running Meta lead ads without firing server-side accepted-lead events, you are training Meta on the wrong outcome. The whole point of a meta capi integration for a lead-gen advertiser is to send buyer outcomes back, not just form-fills."

Deduplication and what Meta sees on the receiving end

Deduplication is the part that trips up most teams. On a Lead Distro AI funnel, the funnel's Meta card fires the Lead event from the visitor's browser and the same Lead event from our server, with the same event_id. Meta identifies them as one conversion via event_id plus event name plus pixel ID, and counts it once. Without a shared event_id, you would see double counts in Events Manager and a misleadingly high CPM in Ads Manager because Meta is bidding to hit a doubled conversion target.

The Settings integration sends server events only, each with a deterministic event_id built from the lead and the outcome. A Retry from the CAPI Event column re-uses the same event_id and does not create a duplicate. Meta's documented dedup window is 48 hours for events with matching event_id, event name, and pixel ID, so a lead retried four hours after a failed attempt is still counted once.

When the funnel and Settings send the same event to one pixel

The funnel's events and the Settings events carry different event_id values, so Meta cannot merge them on its own. If both sent Lead to the same pixel, Meta would count every funnel lead twice and bid against a doubled conversion count. Lead Distro AI stops that before it happens:

  1. A lead arrives from a Lead Distro AI funnel that has its Meta card turned on.
  2. Before the Settings integration sends an event for that lead, it checks the funnel's Meta card.
  3. If the pixel is the same and the funnel already sends that event name, the Settings copy is skipped.
  4. Any other event name still goes, so LeadAccepted or Purchase from Settings reaches Meta as normal.

The skip shows on the Leads page. Hover the lead's CAPI Event cell and it reads "Skipped to prevent double counting". Leads that arrive by API, or from a form that is not a Lead Distro AI funnel, are never skipped, because nothing else sent them to Meta. If you want Settings to report a later outcome for funnel leads, give that outcome its own event name in the event mapping.

Where this integration fits in the bigger picture

The meta capi integration is one of about a dozen native connectors in Lead Distro AI; the full list of CRMs, ad platforms, billing systems, and lead-quality tools lives on the Lead Distro AI integrations page. On the inbound side, Facebook Lead Forms ingestion through the Meta webhook automatically captures the fbclid and feeds it into the CAPI event payload downstream, so the loop is closed without you handling tokens at all. On the outbound side, the same lead can be delivered via the public Lead Distro AI distribution API to any buyer system, with CAPI events firing independently of delivery.

If you want to see the full set of platform capabilities first, start with the product tour and the Meta integration sits two clicks deep under Settings. If you already know you want the integration, the fastest path is to wire it during onboarding alongside your first Meta lead-ad campaign. The free trial covers the full Meta CAPI integration so you can validate event delivery against your own Events Manager before committing.

FAQ

Does Lead Distro AI support the Meta Conversions API?

Yes. Lead Distro AI ships with a native Meta CAPI integration that fires server-side Lead, LeadAccepted, LeadConverted, and Purchase events to any Meta Pixel you connect. The integration supports multiple pixels per organization, per-supplier pixel wiring, automatic deduplication with the browser pixel via shared event_id, and per-lead delivery visibility on the Leads page.

What events does the Lead Distro AI Meta CAPI integration send?

The integration sends the standard Lead event when a lead is accepted into the platform, plus custom LeadAccepted and LeadConverted events when a buyer marks the lead in the buyer portal, plus the standard Purchase event when a monetary value is attached. Custom events appear in Meta Events Manager next to standard events and can be used as optimization goals in campaigns.

How does Lead Distro AI deduplicate Meta CAPI events with the browser pixel?

On a Lead Distro AI funnel, the funnel's Meta card fires the browser pixel and the server-side CAPI event with the same event_id. Meta matches on event_id plus event name plus Pixel ID within a 48-hour dedup window and counts the conversion exactly once. The Settings integration is server-only, and a Retry from the CAPI Event column re-uses the same event_id, so retries never double-count either.

Should I set up Meta CAPI in my funnel or in Settings?

If your leads come from a Lead Distro AI funnel, set it up on the funnel: open the funnel, go to Integrations, and click the Meta card. It sends browser and server events together, so Meta counts each lead once and matches more of them. Use Settings > Integrations for leads that arrive by API or from other forms, or to report later outcomes like accepted or converted. You can use both on one pixel: when they send the same event name, Lead Distro AI skips the Settings copy for funnel leads, so Meta counts each lead once.

What if my funnel and Settings both send Lead to the same pixel?

Lead Distro AI sends it once. For a lead from a funnel whose Meta card uses that pixel, the Settings integration skips any event with a name the funnel already sends, and the lead's CAPI Event cell says it was skipped to prevent double counting. Events with a different name, like LeadAccepted, still go out.

Can I connect multiple Meta Pixels to one Lead Distro AI account?

Yes. Add as many Meta CAPI integrations as you need under Settings > Integrations, each with its own Pixel ID, access token, and event mapping. Each campaign picks a single integration in its Settings tab, and for multi-supplier campaigns you can wire each supplier to its own pixel from the Sources cell, so brokerage and aggregator models work without mixing ad-account signals.

What happens if a Meta CAPI event fails to send?

The lead row shows Not sent in the CAPI Event column with the failure reason on hover (invalid_access_token, pixel_not_found, network_error, or a verbatim Meta error). Each row gets a one-click Retry button that re-fires the event using the same event_id, so once the underlying issue is fixed the retry is safe and dedupes cleanly on Meta's side.

How long does it take to set up Lead Distro AI Meta CAPI?

About five minutes once you have the Pixel ID and a Meta system user access token in hand. The longer path is generating the access token in Meta Business Settings, which is a one-time five-to-ten-minute setup per ad account. After that, adding the integration and wiring it to a campaign in Lead Distro AI is a single screen.

Wrap-up

The Lead Distro AI Meta CAPI integration is a five-minute wire-up that closes the attribution gap iOS 14.5 opened, with native support for multi-pixel agencies, per-supplier wiring, automatic deduplication, and per-lead delivery visibility. If you are running Meta lead ads and your buyers complain about lead quality, the fastest fix is not a new ad creative, it is firing accepted-lead and converted-lead events back to Meta so the algorithm can stop optimizing for vanity form-fills. Start your free trial and you can have the first server-side meta capi event flowing in under ten minutes.

About the Author

Rafael Hernandez, Founder & CEO of Lead Distro AI
Rafael Hernandez

Founder & CEO of Lead Distro AI & Great Marketing AI

UC Berkeley graduate and former software engineer at Microsoft. Rafael built Lead Distro AI after managing over $10M in ad spend for performance marketing agencies (pay-per-lead and pay-per-call), including running campaigns for Neil Patel. He combines deep software engineering expertise with hands-on performance marketing experience to build tools that help these agencies scale profitably.

Follow:

About Lead Distro AI

Capture, Route, and Sell Every Lead, Call, and Appointment

Capture, route, and sell leads, calls, and appointments from one platform, with funnels, call tracking, ping-post, and billing built in. Set it all up in minutes by chatting with AI.

  • Funnels

    Quiz, form, appointment, VSL, and webinar templates

  • Call Tracking

    Tracking numbers, call recordings, and per-call billing

  • 4 Distribution Methods

    Priority/Waterfall, Round Robin, Weighted, Ping-Post

  • Ping-Post and Live Bidding

    Sell each lead and call to the highest bid

  • Real-Time P&L

    Revenue, cost, and profit per campaign

  • Partner Portal

    Your Destinations see their own leads and results

Start Free Trial
7-day free trialCancel anytime5-minute setup