Capture-demand swarm · Lead-Scoring-Routing Agent · Multi-source-lead-ingestion skill · Build pillar · Published July 10, 2026

How to build multi-source attribution-preserving lead ingestion for multi-location franchises

This guide explains how to architect the multi-source-lead-ingestion skill on the lead-scoring-routing agent end-to-end at multi-location franchise + multi-store scale: per-portfolio per-location per-lead per-canonical-multi-source-lead-capture + per-UTM-click-ID-preservation + per-attribution-preservation + per-per-lead-deduplication + per-per-lead-master-record-resolution + per-per-location-routing + per-spam-detection + per-GDPR-CCPA-CASL-PIPEDA-consent-management + per-per-lead-enrichment-handoff + per-per-lead-CRM-emission + per-per-lead-audit-trail + per-portfolio audit-trail.

Engage the lead-scoring-routing agent See the 32-agent swarm

What you will build

Per-portfolio per-canonical-multi-source-lead-capture across per-Meta Lead Ads Graph API + per-Google Lead Form Extensions API + per-TikTok Lead Generation API + per-LinkedIn Lead Gen Forms API + per-Pinterest Lead Ads + per-Snapchat Lead Gen + per-Typeform + per-Jotform + per-Gravity Forms + per-WPForms + per-Formstack + per-HubSpot Forms + per-Salesforce Web-to-Lead + per-Marketo + per-Unbounce + per-Instapage + per-Leadpages + per-ConvertKit + per-website RSVP + per-phone call (CallRail + Invoca) + per-SMS (Twilio) + per-chat (Intercom + Drift) handoff.
Per-canonical-UTM-click-ID-preservation — per-UTM source/medium/campaign/term/content + per-gclid + per-fbclid + per-msclkid + per-ttclid + per-li_fat_id + per-twclid + per-epik + per-snap click-ID + per-custom click-ID.
Per-canonical-attribution-preservation — per-first-party cookie CHIPS + per-server-side GTM + per-Meta Conversions API + per-Google Enhanced Conversions + per-Microsoft UET Enhanced Conversions + per-TikTok Events API + per-LinkedIn + Pinterest + Snapchat + Reddit Conversions API + per-cross-device + per-cross-touchpoint via identity resolution.
Per-canonical-per-lead-deduplication — per-deterministic (SHA-256 hashed email + E.164 phone + customer-ID) + per-probabilistic (fuzzy name + email typo + IP/device fingerprint) + per-window (60-sec/1-hour/24-hour/30-day) + per-confidence scoring.
Per-canonical-per-lead-master-record-resolution + per-per-location-routing — per-cross-source master-record merge + per-survivorship rule + per-first-touch/last-touch preservation + per-cross-source consent merge + per-LTV attribution aggregation + per-DID + per-ZIP code territory + per-IP geo + per-state + per-radius from store pin + per-DMA + per-CBSA + per-territory overlap resolution + per-FDD Item 12 attestation + per-fallback to corporate.
Per-canonical-spam-detection + per-GDPR-CCPA-CASL-PIPEDA-consent-management — per-multi-LLM (GPT-4o + Claude Sonnet + Gemini Pro) + per-honeypot + per-time-to-completion anomaly + per-IP rate limit + per-CAPTCHA (reCAPTCHA v3 + hCaptcha + Turnstile) + per-disposable email/phone detection + per-IP blocklist + per-behavioral fingerprinting + per-spam confidence score + per-OneTrust/Cookiebot/Usercentrics/Didomi + per-consent state + source + versioning + per-DSAR + per-right-to-erasure + per-CASL Canadian opt-in attestation.
Per-canonical-per-lead-enrichment-handoff + per-CRM-emission + per-audit-trail — per-firmographic enrichment (Clearbit + ZoomInfo + Apollo + Cognism) + per-real-time vs async batch + per-handoff to bant-scoring/firmographic-enrichment skill + per-CRM emission (Salesforce + HubSpot + Pipedrive + Zoho + Microsoft Dynamics 365) + per-cross-system deduplication + per-field mapping + per-merge strategy + per-latency + per-DLQ + per-canonical audit record (lead-ID + source + UTM + click-ID + attribution touchpoints + deduplication decision + spam decision + consent state + routing decision + enrichment result + CRM emission status + FCC/TCPA/CASL/PIPEDA/GDPR/CCPA/FDD attestation) + per-FCC TCPA + CASL CRTC + PIPEDA OPC + GDPR DPIA + CCPA DSAR exports + per-immutable WORM storage.

Why per-vendor-HubSpot-Forms-single-account breaks at multi-location multi-source franchise scale

Per-vendor-HubSpot-canonical-Forms ships per-account per-form per-submission primitive. Per-vendor-Typeform + Jotform + Gravity Forms + WPForms + Formstack + Salesforce Web-to-Lead + Marketo + Unbounce + Instapage + Leadpages + ConvertKit-canonical-single-account ship per-vendor per-native lead-capture primitives.

At 1-source-1-form scale per-account per-form per-submission primitive is enough. At multi-location multi-source franchise scale per-multi-source-lead-capture-cross-vendor + per-UTM-click-ID-preservation-server-side-cookie + per-attribution-preservation-Conversions-API-first-party-cookie + per-per-lead-deduplication-email-phone-fuzzy-match + per-per-lead-master-record-resolution-cross-source + per-per-location-routing-DID-ZIP-IP-state + per-spam-detection-multi-LLM + per-GDPR-CCPA-CASL-PIPEDA-consent-OneTrust-Didomi-Cookiebot + per-per-lead-enrichment-handoff-Clearbit-ZoomInfo-Apollo + per-per-lead-CRM-emission-Salesforce-HubSpot-Pipedrive-Zoho + per-per-lead-audit-trail-FCC-TCPA-CASL-PIPEDA-GDPR-CCPA-multi-format + per-FDD-Item-12.

Per-cross-vendor-lead-capture-fragmentation + per-UTM-preservation-blind + per-attribution-preservation-blind + per-deduplication-blind + per-master-record-resolution-blind + per-location-routing-blind + per-spam-detection-blind + per-consent-management-blind + per-enrichment-handoff-blind + per-CRM-emission-blind + per-multi-format-audit-trail-blind.

The operator-side architecture above per-vendor-lead-capture primitive is canonical-multi-source-lead-capture + per-UTM-click-ID-preservation + per-attribution-preservation + per-per-lead-deduplication + per-per-lead-master-record-resolution + per-per-location-routing + per-spam-detection + per-GDPR-CCPA-CASL-PIPEDA-consent-management + per-per-lead-enrichment-handoff + per-per-lead-CRM-emission + per-per-lead-audit-trail + per-portfolio-audit-trail.

What is in market today

Per-platform per-lead-capture-vendor

Meta Lead Ads, Google Lead Form Extensions, TikTok Lead Generation, LinkedIn Lead Gen Forms, Pinterest Lead Ads, Snapchat Lead Gen, Typeform, Jotform, Gravity Forms, WPForms, Formstack, HubSpot Forms, Salesforce Web-to-Lead, Marketo, Unbounce, Instapage, Leadpages, ConvertKit, Zapier, Workato, Tray.io, Make (Integromat). Per-account per-form per-submission. Per-canonical-multi-source-cross-vendor-canonical-UTM-click-ID-preservation-canonical-attribution-preservation-canonical-per-lead-deduplication-canonical-per-location-routing-canonical-spam-detection-canonical-consent-management is not the primitive.

Per-platform per-conversions-API-vendor

Meta Conversions API, Google Enhanced Conversions, Microsoft UET Enhanced Conversions, TikTok Events API, LinkedIn Conversions API, Pinterest Conversions API, Snapchat Conversions API, Reddit Conversion API, Twitter X Conversions API. Per-account per-event primitive. Per-canonical-server-side-tagging-Google-Tag-Manager-server-container-canonical-first-party-cookie-CHIPS-canonical-cross-device-canonical-cross-touchpoint-via-identity-resolution is not the primitive.

Per-platform per-spam-detection-vendor

Google reCAPTCHA v3, hCaptcha, Cloudflare Turnstile, FunCAPTCHA (Arkose Labs), DataDome, PerimeterX (HUMAN Security), Akamai Bot Manager, Imperva Bot Management. Per-account per-site-key primitive. Per-canonical-multi-LLM-spam-detection-canonical-honeypot-canonical-time-to-completion-canonical-disposable-email-phone-canonical-IP-blocklist-canonical-behavioral-fingerprinting-canonical-spam-confidence is not the primitive.

Per-platform per-CRM-emission-vendor

Salesforce Sales Cloud, HubSpot Sales Hub, Pipedrive, Zoho CRM, Microsoft Dynamics 365, Sugar CRM, Insightly, Copper, Close, Freshsales, monday sales CRM. Per-account per-lead primitive. Per-canonical-per-CRM-emission-canonical-cross-system-deduplication-canonical-field-mapping-canonical-merge-strategy-canonical-emission-latency-canonical-failure-fallback-DLQ is not the primitive.

How the architecture is built

Per-portfolio per-canonical-multi-source-lead-capture-substrate. Per-Meta + per-Google + per-TikTok + per-LinkedIn + per-Pinterest + per-Snapchat + per-Typeform + per-Jotform + per-Gravity-Forms + per-WPForms + per-Formstack + per-HubSpot-Forms + per-Salesforce-Web-to-Lead + per-Marketo + per-Unbounce + per-Instapage + per-Leadpages + per-ConvertKit + per-website-RSVP + per-phone-call + per-SMS + per-chat canonical-multi-source.
Per-portfolio per-canonical-UTM-click-ID-preservation. Per-UTM-source-medium-campaign-term-content + per-gclid + per-fbclid + per-msclkid + per-ttclid + per-li_fat_id + per-twclid + per-epik + per-snap-click-ID + per-custom-click-ID canonical-preservation.
Per-portfolio per-canonical-attribution-preservation. Per-first-party-cookie-CHIPS + per-server-side-GTM + per-Meta-Conversions-API + per-Google-Enhanced-Conversions + per-Microsoft-UET-Enhanced-Conversions + per-TikTok-Events-API + per-LinkedIn-Conversions-API + per-Pinterest-Conversions-API + per-Snapchat-Conversions-API + per-Reddit-Conversion-API + per-cross-device + per-cross-touchpoint canonical-attribution.
Per-portfolio per-canonical-per-lead-deduplication. Per-deterministic-SHA-256-email-E.164-phone-customer-ID + per-probabilistic-fuzzy-name-email-typo-IP-device-fingerprint + per-window-60-sec-1-hour-24-hour-30-day + per-confidence-scoring canonical-deduplication.
Per-portfolio per-canonical-per-lead-master-record-resolution. Per-cross-source-merge + per-survivorship-rule + per-first-touch-last-touch-preservation + per-cross-source-consent-merge + per-LTV-attribution-aggregation canonical-resolution.
Per-portfolio per-canonical-per-location-routing. Per-DID + per-ZIP + per-IP-geo + per-state + per-radius-from-store-pin + per-DMA + per-CBSA + per-territory-overlap + per-FDD-Item-12 + per-fallback-to-corporate canonical-routing.
Per-portfolio per-canonical-spam-detection. Per-multi-LLM + per-honeypot + per-time-to-completion + per-IP-rate-limit + per-CAPTCHA + per-disposable-email-phone + per-IP-blocklist + per-behavioral-fingerprinting + per-spam-confidence canonical-spam.
Per-portfolio per-canonical-GDPR-CCPA-CASL-PIPEDA-consent-management. Per-OneTrust-Cookiebot-Usercentrics-Didomi + per-consent-state + per-source + per-state-versioning + per-DSAR + per-right-to-erasure + per-CASL-attestation canonical-consent.
Per-portfolio per-canonical-per-lead-enrichment-handoff. Per-Clearbit-ZoomInfo-Apollo-Cognism + per-real-time-vs-async-batch + per-handoff-to-bant-scoring + per-handoff-to-firmographic-enrichment canonical-handoff.
Per-portfolio per-canonical-per-lead-CRM-emission. Per-Salesforce + per-HubSpot + per-Pipedrive + per-Zoho + per-Microsoft-Dynamics-365 + per-cross-system-deduplication + per-field-mapping + per-merge-strategy + per-latency + per-DLQ canonical-CRM.
Per-portfolio per-canonical-per-lead-audit-trail. Per-lead-canonical-audit-record + per-FCC-TCPA + per-CASL-CRTC + per-PIPEDA-OPC + per-GDPR-DPIA + per-CCPA-DSAR + per-immutable-WORM canonical-audit.
Per-portfolio per-portfolio-audit-trail-immutable-storage. Per-CSV-export + per-tamper-evident-hash-chain canonical-immutable.
Per-portfolio per-lead-scoring-routing-agent-bundle. Per-lead-capture-form + per-firmographic-enrichment + per-bant-scoring + per-lead-enrichment + per-multi-location-bant-lead-scoring canonical-bundle.

Frequently asked questions

What is multi-source attribution-preserving lead ingestion for multi-location franchises?

Multi-source attribution-preserving lead ingestion runs per-portfolio per-location per-lead per-canonical-multi-source-lead-capture + per-canonical-UTM-click-ID-preservation + per-canonical-attribution-preservation-cookie-server-side + per-canonical-per-lead-deduplication + per-canonical-per-lead-master-record-resolution + per-canonical-per-location-routing + per-canonical-spam-detection + per-canonical-GDPR-CCPA-CASL-PIPEDA-consent-management + per-canonical-per-lead-enrichment-handoff + per-canonical-per-lead-CRM-emission + per-canonical-per-lead-audit-trail + per-portfolio audit-trail. Per-canonical-multi-source-lead-capture runs per-portfolio per-canonical-Meta-Lead-Ads-Graph-API + per-canonical-Google-Lead-Form-Extensions-API + per-canonical-TikTok-Lead-Generation-API + per-canonical-LinkedIn-Lead-Gen-Forms-API + per-canonical-Pinterest-Lead-Ads-API + per-canonical-Snapchat-Lead-Gen-API + per-canonical-Typeform-API + per-canonical-Jotform-API + per-canonical-Gravity-Forms-webhook + per-canonical-WPForms-webhook + per-canonical-Formstack-webhook + per-canonical-HubSpot-Forms-webhook + per-canonical-Salesforce-Web-to-Lead-API + per-canonical-Marketo-API + per-canonical-Unbounce-Instapage-Leadpages-webhook + per-canonical-website-RSVP-form + per-canonical-phone-call-CallRail-Invoca-handoff + per-canonical-SMS-Twilio-handoff + per-canonical-chat-Intercom-Drift-handoff. The per-platform lead-capture vendor category includes Meta Lead Ads, Google Lead Form Extensions, TikTok Lead Generation, LinkedIn Lead Gen Forms, Pinterest Lead Ads, Snapchat Lead Gen, Typeform, Jotform, Gravity Forms, WPForms, Formstack, HubSpot Forms, Salesforce Web-to-Lead, Marketo, Unbounce, Instapage, Leadpages, ConvertKit, Zapier, Workato, Tray.io, Make (Integromat).

Why does per-vendor-HubSpot-canonical-Forms-canonical-single-account break down at multi-location-multi-source franchise scale?

Per-vendor-HubSpot-canonical-Forms ships per-account per-form per-submission primitive. Per-vendor-Typeform + per-Jotform + per-Gravity-Forms + per-WPForms + per-Formstack + per-Salesforce-Web-to-Lead + per-Marketo + per-Unbounce + per-Instapage + per-Leadpages + per-ConvertKit-canonical-single-account ship per-vendor per-native lead-capture primitives. At 1-source-1-form scale per-account per-form per-submission primitive is enough. At multi-location multi-source franchise scale per-canonical-multi-source-lead-capture-canonical-cross-vendor + per-canonical-UTM-click-ID-preservation-canonical-server-side-cookie + per-canonical-attribution-preservation-canonical-Conversions-API-first-party-cookie + per-canonical-per-lead-deduplication-canonical-email-phone-fuzzy-match + per-canonical-per-lead-master-record-resolution-canonical-cross-source + per-canonical-per-location-routing-canonical-DID-ZIP-IP-state-routing + per-canonical-spam-detection-canonical-multi-LLM-ensemble + per-canonical-GDPR-CCPA-CASL-PIPEDA-consent-management-canonical-OneTrust-Didomi-Cookiebot + per-canonical-per-lead-enrichment-handoff-canonical-Clearbit-ZoomInfo-Apollo + per-canonical-per-lead-CRM-emission-canonical-Salesforce-HubSpot-Pipedrive-Zoho + per-canonical-per-lead-audit-trail-canonical-FCC-TCPA-CASL-PIPEDA-GDPR-CCPA-multi-format-export + per-canonical-FDD-Item-12-territorial-rights.

How does per-portfolio per-canonical-multi-source-lead-capture + per-UTM-click-ID-preservation + per-attribution-preservation work?

Per-portfolio per-canonical-multi-source-lead-capture runs per-portfolio per-canonical-per-source-API-spec + per-canonical-per-source-webhook-spec + per-canonical-per-source-OAuth-authentication + per-canonical-per-source-rate-limit + per-canonical-per-source-pagination + per-canonical-per-source-field-schema-canonicalization + per-canonical-per-source-error-handling + per-canonical-per-source-retry-policy. Per-canonical-UTM-click-ID-preservation runs per-portfolio per-canonical-UTM-source-medium-campaign-term-content-preservation + per-canonical-gclid-Google-Click-ID-preservation + per-canonical-fbclid-Facebook-Click-ID-preservation + per-canonical-msclkid-Microsoft-Click-ID-preservation + per-canonical-ttclid-TikTok-Click-ID-preservation + per-canonical-li-fat-id-LinkedIn-Click-ID-preservation + per-canonical-twclid-Twitter-X-Click-ID-preservation + per-canonical-epik-Pinterest-Click-ID-preservation + per-canonical-snap-click-ID-preservation + per-canonical-custom-click-ID-preservation. Per-canonical-attribution-preservation runs per-portfolio per-canonical-first-party-cookie-CHIPS-Cookie-Having-Independent-Partitioned-State + per-canonical-server-side-tagging-Google-Tag-Manager-server-container + per-canonical-Meta-Conversions-API + per-canonical-Google-Enhanced-Conversions + per-canonical-Microsoft-UET-Enhanced-Conversions + per-canonical-TikTok-Events-API + per-canonical-LinkedIn-Conversions-API + per-canonical-Pinterest-Conversions-API + per-canonical-Snapchat-Conversions-API + per-canonical-Reddit-Conversion-API + per-canonical-cross-device-attribution + per-canonical-cross-touchpoint-attribution-via-identity-resolution.

What does per-portfolio per-canonical-per-lead-deduplication + per-master-record-resolution + per-location-routing do?

Per-portfolio per-canonical-per-lead-deduplication runs per-portfolio per-canonical-deterministic-deduplication (per-shared-email-hashed-SHA-256 + per-shared-phone-E.164 + per-shared-customer-ID per-canonical-deterministic) + per-canonical-probabilistic-deduplication (per-fuzzy-name-Levenshtein-Jaro-Winkler + per-fuzzy-email-typo-detection + per-IP-device-fingerprint per-canonical-probabilistic) + per-canonical-deduplication-window-spec (per-60-second + per-1-hour + per-24-hour + per-30-day per-canonical-window) + per-canonical-deduplication-confidence-scoring. Per-canonical-per-lead-master-record-resolution runs per-portfolio per-canonical-cross-source-master-record-merge + per-canonical-cross-source-survivorship-rule + per-canonical-cross-source-attribution-merge-preserve-first-touch-preserve-last-touch + per-canonical-cross-source-consent-state-merge + per-canonical-cross-source-LTV-attribution-aggregation. Per-canonical-per-location-routing runs per-portfolio per-canonical-per-location-routing-spec (per-DID-Direct-Inward-Dialing + per-ZIP-code-territory + per-IP-geolocation + per-state-territory + per-radius-from-store-pin + per-DMA + per-CBSA per-canonical-routing-spec) + per-canonical-per-location-territory-overlap-resolution + per-canonical-per-location-FDD-Item-12-attestation + per-canonical-per-location-routing-fallback-to-corporate.

What does per-portfolio per-canonical-spam-detection + per-GDPR-CCPA-CASL-consent-management + per-lead-enrichment-handoff do?

Per-portfolio per-canonical-spam-detection runs per-portfolio per-canonical-multi-LLM-spam-detection (per-GPT-4o + per-Claude-Sonnet + per-Gemini-Pro per-canonical-LLM) + per-canonical-honeypot-field-spec + per-canonical-time-to-completion-anomaly-detection + per-canonical-rate-limit-per-IP + per-canonical-CAPTCHA-reCAPTCHA-v3-hCaptcha-Turnstile + per-canonical-disposable-email-detection + per-canonical-temporary-phone-detection + per-canonical-known-spam-source-IP-blocklist + per-canonical-behavioral-fingerprinting + per-canonical-spam-confidence-score-spec. Per-canonical-GDPR-CCPA-CASL-PIPEDA-consent-management runs per-portfolio per-canonical-OneTrust-Cookiebot-Usercentrics-Didomi-consent-management-platform + per-canonical-per-lead-consent-state-tracking + per-canonical-per-lead-consent-source-tracking + per-canonical-per-lead-consent-state-versioning + per-canonical-per-lead-DSAR-data-subject-access-request-fulfillment + per-canonical-per-lead-right-to-erasure-fulfillment + per-canonical-per-lead-CASL-Canadian-opt-in-attestation. Per-canonical-per-lead-enrichment-handoff runs per-portfolio per-canonical-per-lead-firmographic-enrichment (per-Clearbit + per-ZoomInfo + per-Apollo + per-Cognism per-canonical-firmographic) + per-canonical-per-lead-real-time-vs-async-batch-enrichment + per-canonical-per-lead-enrichment-handoff-to-bant-scoring-skill + per-canonical-per-lead-enrichment-handoff-to-firmographic-enrichment-skill.

What does per-portfolio per-canonical-per-lead-CRM-emission + per-audit-trail + per-lead-scoring-routing-agent-canonical-bundle do?

Per-portfolio per-canonical-per-lead-CRM-emission runs per-portfolio per-canonical-per-CRM-emission-spec (per-Salesforce + per-HubSpot + per-Pipedrive + per-Zoho + per-Microsoft-Dynamics-365 per-canonical-CRM) + per-canonical-per-CRM-deduplication-cross-system + per-canonical-per-CRM-field-mapping + per-canonical-per-CRM-merge-strategy + per-canonical-per-CRM-emission-latency-spec + per-canonical-per-CRM-emission-failure-fallback-DLQ. Per-canonical-per-lead-audit-trail runs per-portfolio per-canonical-per-lead-canonical-audit-record (per-lead-ID + per-source + per-UTM + per-click-ID + per-attribution-touchpoints + per-deduplication-decision + per-spam-decision + per-consent-state + per-routing-decision + per-enrichment-result + per-CRM-emission-status + per-FCC-TCPA-CASL-PIPEDA-GDPR-CCPA-FDD-attestation per-canonical-audit-record) + per-canonical-audit-trail-FCC-TCPA-export + per-canonical-audit-trail-CASL-CRTC-export + per-canonical-audit-trail-PIPEDA-OPC-export + per-canonical-audit-trail-GDPR-DPIA-export + per-canonical-audit-trail-CCPA-DSAR-export + per-canonical-audit-trail-immutable-WORM-storage. Per-lead-scoring-routing-agent-canonical-bundle integrates the multi-source-lead-ingestion skill with sibling skills on the same agent: per-canonical-lead-capture-form (sibling, parent commercial pillar at /lead-capture-form) + per-canonical-firmographic-enrichment (sibling, build-pillar shipped at /how-to-build-firmographic-enrichment-lead-routing — downstream consumer of ingested lead) + per-canonical-bant-scoring (sibling, build-pillar shipped at /how-to-build-buyer-state-aware-bant-scoring — downstream consumer of enriched lead) + per-canonical-lead-enrichment (sibling, complementary enrichment substrate) + per-canonical-multi-location-bant-lead-scoring (sibling, complementary per-location lead scoring).

Engage the lead-scoring-routing agent

Per-portfolio per-location per-lead per-canonical-multi-source-lead-capture + per-UTM-click-ID-preservation + per-attribution-preservation + per-per-lead-deduplication + per-per-lead-master-record-resolution + per-per-location-routing + per-spam-detection + per-GDPR-CCPA-CASL-PIPEDA-consent-management + per-per-lead-enrichment-handoff + per-per-lead-CRM-emission + per-per-lead-audit-trail + per-portfolio audit-trail shipped as the orchestration layer above your existing per-lead-capture-vendor + per-conversions-API-vendor + per-spam-detection-vendor + per-CRM-emission-vendor primitive.

Book a scope call Browse the 32-agent catalog