✨ Why LeadMagic + n8n?

Transform your lead generation and B2B automation with the most accurate email finding and comprehensive company intelligence available. LeadMagic's industry-leading 95%+ accuracy rate makes it the top choice for enterprise sales teams and marketing automation.

🎯 Key Benefits

• 🏆 Market Leader: 95%+ email finding accuracy (highest in industry)
• ⚡ Bulk Processing: Validate up to 1,000 emails in one operation
• 🌍 Global Coverage: 200M+ professionals, 50M+ companies worldwide
• 🔄 Real-time Data: Fresh, verified information updated continuously
• 🛡️ Enterprise Ready: SOC2 compliant, 99.9% uptime SLA

🎯 Core Features

📧 Email Intelligence (Most Popular)

🏢 Company Intelligence

👥 People & Profile Enrichment

💼 Additional Intelligence

🚀 Quick Start

1️⃣ Install

# In n8n: Settings → Community Nodes → Install
n8n-nodes-leadmagic

2️⃣ Configure

# Add LeadMagic API credential in n8n
API Key: [Your LeadMagic API Key]

3️⃣ Use

Drag the LeadMagic node into your workflow and start automating!

📋 Ready-to-Use Templates

Get started instantly with our professional workflow templates:

📋 Browse All Templates →

💻 Installation Guide

Method 1: n8n Community Nodes (Recommended)

1. Open your n8n instance
2. Navigate to Settings → Community Nodes
3. Click Install a Community Node
4. Enter: n8n-nodes-leadmagic
5. Click Install and wait for completion
6. Restart n8n if required

Method 2: npm Installation

# For self-hosted n8n
cd ~/.n8n
npm install n8n-nodes-leadmagic
n8n start

Method 3: Docker Environment

# Add to your Dockerfile or docker-compose
RUN npm install -g n8n-nodes-leadmagic

# Or mount and install
docker exec -it n8n-container npm install n8n-nodes-leadmagic

Prerequisites

• ✅ n8n version 0.190.0+
• ✅ Node.js 18.10+
• ✅ LeadMagic API Key

🔐 Configuration

Step 1: Get Your API Key

1. Sign up at LeadMagic
2. Navigate to Dashboard → API Settings
3. Generate a new API key
4. Copy the key securely

Step 2: Add Credential in n8n

1. Go to Credentials → Add Credential
2. Search for LeadMagic API
3. Paste your API key
4. Test the connection
5. Save with a descriptive name

🎯 Usage Examples

🔍 Email Finding Workflow

// Find verified work email
{
  "resource": "email",
  "operation": "findEmail",
  "first_name": "John",
  "last_name": "Smith", 
  "domain": "microsoft.com"
}
// Result: john.smith@microsoft.com (95%+ accuracy)

✅ Bulk Email Validation

// Validate up to 1,000 emails
{
  "resource": "email",
  "operation": "validateEmail",
  "inputMode": "bulk",
  "bulkEmails": "email1@company.com\nemail2@company.com\n..."
}
// Result: Deliverability scores + company data for each

🏢 Company Intelligence Pipeline

// Get comprehensive company data
{
  "resource": "company", 
  "operation": "searchCompany",
  "searchMethod": "domain",
  "domain": "salesforce.com"
}
// Result: Employees, revenue, funding, industry data

🔄 Complete Lead Enrichment

// Multi-step enrichment workflow
1. Find Email (Name + Domain) → Email Address
2. Validate Email → Deliverability + Company
3. Email to Profile → Social + Professional Data
4. Company Search → Business Intelligence

📊 API Coverage & Performance

Complete API Integration

Total: 22 Operations • 7 Resources • 100% API Coverage

Performance Metrics

• 🎯 Accuracy: 95%+ email finding success rate
• ⚡ Speed: < 500ms average response time
• 🔄 Reliability: 99.9% uptime SLA
• 📈 Scale: Handle 1,000+ requests per workflow

🛠️ Advanced Features

Bulk Processing

• Process up to 1,000 emails simultaneously
• Automatic rate limiting and queue management
• Progress tracking and error handling
• Configurable delays and retry logic

Error Handling

• Graceful failure handling with detailed error messages
• "Continue on Fail" support for data enrichment workflows
• Retry logic for transient failures
• Comprehensive logging and debugging

Output Customization

• Full details, minimal, or company-focused output modes
• Custom field mapping and data transformation
• Conditional logic based on data quality scores
• Integration with n8n's data processing capabilities

🔧 Development

Local Development

# Clone and setup
git clone https://github.com/LeadMagic/leadmagic-n8n.git
cd leadmagic-n8n
pnpm install

# Development mode
pnpm run dev

# Build for production
pnpm run build

Testing & Quality

# Lint code
pnpm run lint

# Format code  
pnpm run format

# Type checking
pnpm run type-check

📚 Resources

📖 Documentation

• LeadMagic API Docs - Complete API reference
• n8n Community Nodes - Integration guide
• Workflow Templates - Ready-to-use examples

🔗 Links

• LeadMagic Platform - Sign up and dashboard
• npm Package - Latest releases
• GitHub Repository - Source code

💬 Community

• GitHub Issues - Bug reports and features
• n8n Community - General n8n support
• Email Support - Direct technical support

🤝 Contributing

We welcome contributions from the community! See our Contributing Guide for details.

Quick Contribution Setup

# 1. Fork the repository
# 2. Create feature branch
git checkout -b feature/amazing-feature

# 3. Make changes and test
pnpm run build && pnpm run lint

# 4. Commit and push
git commit -m "✨ Add amazing feature"
git push origin feature/amazing-feature

# 5. Open Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.