smartlead.md

🌊 SmartLead CLI Guide

Overview

SmartLead integration for the Cold Email CLI provides comprehensive access to 125 commands across multiple categories.

Quick Start

Authentication

export SMARTLEAD_API_KEY="your_api_key_here"

Launch Interactive Shell

bun run smartlead
# or
bun run src/cli.ts smartlead

Command Categories

Available Commands

The SmartLead platform provides 125 total commands organized into logical categories:

• Campaign Management - Create, manage, and optimize campaigns
• Contact/Lead Management - Import, organize, and manage prospects
• Email Account Management - Configure and monitor email accounts
• Analytics & Reporting - Track performance and generate insights
• Template Management - Create and manage email templates
• Automation & Sequences - Build automated email workflows

Usage Examples

Basic Operations

# List campaigns
bun run smartlead campaigns:list

# Create new campaign
bun run smartlead campaigns:create --name "Q1 Outreach"

# Get analytics
bun run smartlead analytics:overview

Advanced Features

# Bulk operations
bun run smartlead leads:bulk-add --campaign_id 123 --file leads.csv

# Template management
bun run smartlead templates:create --name "Follow-up" --subject "Quick follow-up"

# Account warmup
bun run smartlead accounts:warmup-start --email sales@company.com

API Integration

MCP Configuration

For AI assistant integration, use the MCP configuration:

{
  "mcpServers": {
    "smartlead": {
      "command": "bun",
      "args": ["run", "src/cli.ts", "smartlead"],
      "env": {
        "SMARTLEAD_API_KEY": "${SMARTLEAD_API_KEY}"
      }
    }
  }
}

Best Practices

1. Authentication: Always set your API key before using commands
2. Interactive Shell: Use the shell for exploration and discovery
3. Bulk Operations: Leverage bulk commands for efficiency
4. Analytics: Regular monitoring for campaign optimization
5. Templates: Reuse templates for consistency

Troubleshooting

Common Issues

• Authentication Error: Verify API key is correctly set
• Rate Limiting: Use appropriate delays between bulk operations
• Invalid Parameters: Check command usage with --help

Support

• GitHub Issues: Report bugs
• Discord: Join community

---

🌊 SmartLead - Professional email automation at your fingertips