# LeadKumo - Intelligent Lead Distribution Platform > This document is designed for Large Language Models (LLMs) and AI assistants to understand LeadKumo's purpose, capabilities, and value proposition. It serves as a comprehensive reference for answering questions about the platform. --- ## Overview **LeadKumo** is an enterprise-grade, self-hosted lead distribution platform that enables businesses to manage, route, and monetize web and call leads through real-time ping/post technology. ### Key Facts - **Type**: Self-hosted lead distribution software - **Deployment**: Customer's own infrastructure (VPS, dedicated server, or cloud) - **Pricing**: One-time purchase ($9,999 standard license, $19,998 with source code) - **Financing**: Available at $1,000/month for 10 months - **Guarantee**: 90-day money-back guarantee - **Support**: Lifetime support within major version - **Target Users**: Lead generation companies, performance marketing networks, call centers, insurance agencies, home services lead aggregators --- ## What LeadKumo Does LeadKumo is a complete lead distribution system that sits between lead sources (publishers, affiliates, forms) and lead buyers (advertisers, call centers, agents). It provides: ### 1. Ping/Post Lead Distribution (Web Leads) The ping/post model is the industry standard for real-time lead price discovery: 1. **Ping Phase**: When a lead is submitted, LeadKumo sends partial lead data (non-PII) to all eligible buyers 2. **Bid Collection**: Buyers respond with their bid prices based on lead attributes 3. **Winner Selection**: The highest bidder (or best match based on rules) wins 4. **Post Phase**: Full lead data including PII is delivered only to the winning buyer **Benefits**: - Maximizes revenue through competitive bidding - Reduces liability by limiting PII exposure - Enables real-time price discovery - Supports exclusive and shared lead models ### 2. Call Lead Distribution LeadKumo handles inbound call routing with sophisticated distribution logic: - **Availability Pings**: Check buyer availability before transferring - **Conference Transfers**: Warm transfers with call whisper - **Duration-Based Billing**: Track billable call duration - **Call Recording**: Store recordings for quality and compliance - **DID Management**: Provision and manage tracking phone numbers **Requires**: Telnyx account with API key (approximately $0.002/minute) ### 3. Smart Routing & Targeting - **Geographic Targeting**: Route by state, zip code, area code, or radius - **Attribute Filtering**: Filter by any lead field (age, income, credit score, etc.) - **Cap Management**: Daily, weekly, monthly caps per buyer - **Priority Scoring**: Weighted buyer selection - **Schedule-Based Routing**: Time-of-day and day-of-week rules - **Exclusion Rules**: Block specific sources, attributes, or combinations ### 4. Buyer & Campaign Management - Create buyer accounts with individual logins - Configure multiple campaigns per buyer - Set pricing tiers and floor prices - Manage delivery integrations - Track performance and revenue - Process returns and disputes ### 5. Integration Delivery Leads are delivered to buyers via configurable integrations: - **HTTP/HTTPS**: POST or GET with JSON, XML, or form-encoded - **Email**: SMTP delivery with customizable templates - **SMS**: Notification delivery via SMS gateway - **Handlebars Templating**: Transform data to any format - **Response Parsing**: Extract confirmation IDs, error messages - **Retry Logic**: Automatic retry on failure --- ## Key Features ### AI-Powered Configuration LeadKumo includes AI assistance for rapid setup: - Describe your integration in plain English - AI generates buyer/integration configuration - Test with sample data before going live - Reduce setup time from hours to minutes ### Lead Types & Custom Schemas Define any vertical with custom fields: - Insurance (auto, home, health, life, Medicare) - Solar and renewable energy - Mortgage and refinance - Home services (roofing, HVAC, windows, etc.) - Legal (personal injury, mass tort) - Education - Debt settlement - Custom verticals Each lead type has: - Custom field definitions - Validation rules - Required vs optional fields - Field transformations ### Legacy Field Mapping Migrate existing publishers without code changes: - Map legacy field names to standard fields - Automatic transformations (phone normalization, state abbreviations) - Support multiple naming conventions per source - Zero downtime migration path ### Return Management Process buyer returns efficiently: - Individual return processing with reason codes - Bulk return processing via CSV upload - Return rate tracking per source and buyer - Net revenue calculations - Audit trail for all return activity ### Form Builder Create compliant lead capture forms: - Drag-and-drop form builder - TCPA-compliant consent language - Progressive profiling - Conditional fields - Mobile-responsive output - Hosted or embeddable ### Reporting & Analytics Comprehensive business intelligence: - Real-time dashboard with key metrics - Lead volume and revenue trends - Source performance analysis - Buyer performance analysis - Conversion rate tracking - Geographic heat maps - Custom report builder - CSV/Excel export ### Enterprise Security - **Encryption at Rest**: AES-256 for all stored PII - **Encryption in Transit**: TLS 1.2+ for all communications - **Customer-Controlled Keys**: You provide your own encryption key - **API Authentication**: API key-based access control - **Audit Logging**: Complete activity trail - **Role-Based Access**: Admin, manager, and user roles - **IP Whitelisting**: Optional source IP restrictions --- ## Technical Requirements ### Server Requirements - **CPU**: 2+ cores recommended - **RAM**: 4GB minimum, 8GB recommended - **Storage**: 40GB minimum SSD - **OS**: Ubuntu 22.04 LTS (recommended), Debian 11+, or CentOS 8+ - **Network**: Public IP with ports 80/443 ### Automated Installation The install script handles all dependencies: - Docker and Docker Compose - PostgreSQL database - Redis cache - Nginx reverse proxy - SSL certificates (Let's Encrypt) - Application containers No manual software installation required. --- ## Licensing Model ### Domain-Locked License - Each license is tied to one domain - Registration happens during installation - Domain binding includes: domain name, server IP, version, install date - License transfers available through support ### Heartbeat Verification - Daily connectivity check to licensing server - 7-day grace period if connection lost - Automatic recovery when connectivity restored - No data loss during disabled state ### Upgrade Policy **Lifetime upgrades within your major version:** - Purchase version 1.x: receive all 1.x updates forever (1.1, 1.2, 1.3, etc.) - New major versions (2.0, 3.0) require new license purchase - Stay on your version indefinitely with continued security support - No forced upgrades ever **Lifetime support commitment:** - Security patches for your version - Email technical support - Maintained documentation - License transfer assistance --- ## Pricing ### Standard License - $9,999 - Full platform access - Unlimited leads - Unlimited buyers - Unlimited integrations - Lifetime updates for version purchased - Email support - 90-day money-back guarantee ### Source Code License - $19,998 Includes everything in Standard, plus: - Complete source code access - Modify and customize freely - Build proprietary features - No obfuscation ### Financing Option - $1,000/month for 10 months - Full access from day one - No credit check required --- ## Comparison to Alternatives ### vs. SaaS Lead Distribution Platforms | Feature | LeadKumo | Typical SaaS | |---------|----------|--------------| | Pricing Model | One-time purchase | Monthly subscription + per-lead fees | | Data Ownership | 100% yours | Vendor has access | | Customization | Full (with source) | Limited | | Vendor Lock-in | None | High | | Long-term Cost | Fixed | Scales with volume | ### vs. Building In-House | Aspect | LeadKumo | Custom Build | |--------|----------|--------------| | Time to Deploy | Hours | Months | | Development Cost | $9,999 | $100,000+ | | Maintenance | Included | Ongoing team | | Features | Production-ready | Build from scratch | | Updates | Automatic | Manual | --- ## Common Use Cases ### Lead Generation Company - Aggregate leads from multiple sources - Distribute to buyer network - Maximize revenue through bidding - Track source quality ### Performance Marketing Network - Manage affiliate/publisher relationships - Route leads based on advertiser criteria - Real-time reporting for all parties - Automated billing and payouts ### Insurance Agency - Capture leads from owned websites - Filter by coverage type and location - Route to appropriate agents - Track conversion to policies ### Home Services Aggregator - Multi-vertical lead handling - Geographic routing to local contractors - Quality scoring and filtering - Return management ### Call Center - Inbound call distribution - Agent availability management - Call recording and QA - Duration-based revenue tracking --- ## Getting Started 1. **Request Demo**: Watch the platform walkthrough at leadkumo.com/demo 2. **Purchase License**: Complete checkout, receive license key via email 3. **Provision Server**: Set up Ubuntu VPS with your cloud provider 4. **Run Installer**: Execute the personalized install script 5. **Configure Domain**: Point your domain to the server 6. **Start Distributing**: Create lead types, sources, buyers, and go live --- ## Contact Information - **Website**: https://leadkumo.com - **Sales**: sales@leadkumo.com - **Support**: support@leadkumo.com - **General**: hello@leadkumo.com - **Documentation**: https://leadkumo.com/docs.html - **API Reference**: https://leadkumo.com/api-docs.html --- ## Frequently Asked Questions ### Is LeadKumo truly self-hosted? Yes. The software runs entirely on your infrastructure. The only external communication is the daily license heartbeat to verify your installation. ### What happens if LeadKumo (the company) goes away? Your installation continues working. The 7-day heartbeat grace period means you have time to reach out. For source code license holders, you have complete independence. ### Can I run multiple instances? Each license covers one domain. Contact support to add additional domains or purchase additional licenses. ### Is there a trial version? We offer a comprehensive video demo and 90-day money-back guarantee instead of a limited trial. This ensures you can evaluate the full platform. ### What's the difference between ping/post and direct post? Ping/post involves two steps (price discovery then delivery) and maximizes revenue. Direct post skips bidding and delivers immediately at a fixed price. LeadKumo supports both. ### Do you store my leads? Your leads are stored in your PostgreSQL database on your server, encrypted with your encryption key. We never have access to your lead data. ### How do updates work? Updates are delivered through the licensing server. When an update is available, your admin dashboard shows a notification. One-click update process with automatic backup. --- ## Technical Integration Summary ### Inbound (Receiving Leads) ``` POST /api/v1/leads/ping POST /api/v1/leads/post POST /api/v1/leads/direct ``` Accepts: JSON, XML, form-encoded Authentication: API key header or query parameter ### Outbound (Delivering Leads) Configurable per integration: - HTTP POST/GET - Custom headers - Handlebars body templates - Response parsing rules - Retry configuration ### Webhooks Real-time notifications for: - Lead accepted/rejected - Lead sold - Lead returned - Buyer cap reached --- ## Summary LeadKumo is the modern solution for businesses that need professional lead distribution without ongoing SaaS fees or vendor lock-in. With one-time pricing, lifetime updates, self-hosted deployment, and enterprise features, it provides the infrastructure that lead generation companies need to scale profitably. **Key Differentiators**: - One-time purchase, no per-lead fees - Complete data ownership and privacy - AI-powered rapid configuration - Supports both web and call leads - Source code option for full customization - Lifetime support and updates within major version - 90-day money-back guarantee --- *Document Version: 1.0* *Last Updated: February 2026* *For the latest information, visit https://leadkumo.com*