smartlead-campaign-upload-public

Uploads leads CSV and variants YAML to Smartlead as a draft email campaign.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/Pinkycherry/newbusinessideas3 --skill smartlead-campaign-upload-public-pinkycherry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smartlead-campaign-upload-public
Source: https://github.com/Pinkycherry/newbusinessideas3/tree/main/.claude/skills/smartlead-campaign-upload-public
Command: npx skills add https://github.com/Pinkycherry/newbusinessideas3 --skill smartlead-campaign-upload-public-pinkycherry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Manually configuring a Smartlead cold email campaign — creating the campaign, adding A/B/C sequence variants, attaching tagged inboxes, uploading thousands of leads, and setting schedules — is slow and error-prone. This Skill automates the entire API-side setup while keeping the campaign in DRAFT so a human reviews it before launch. ## Core Features & Use Cases - Draft Campaign Creation: Creates the campaign, saves multi-step sequences with A/B/C variants, and never auto-activates — you press Start in the Smartlead UI. - Tag-Scoped Inbox Selection: Filters email accounts by tag, sorts by daily_sent_count (least recently used), and attaches the requested count with automatic removal of rejected inbox IDs. - Validated Batch Lead Upload: Enforces a strict CSV column allowlist (blocking accidental PII upload), then uploads leads in batches of 100 with retry and exponential backoff on rate limits. - Use Case: After generating copy with /campaign-copywriting and verifying your list, run the upload script with your leads.csv and variants.yaml to get a fully configured draft campaign and a review URL in under a minute. ## Quick Start Set the SMARTLEAD_API_KEY environment variable and ask the assistant to run the upload script with your leads.csv and variants.yaml paths to create a draft Smartlead campaign.

Frequently Asked Questions about smartlead-campaign-upload-public

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload leads to a Smartlead campaign via API?

Run the upload script with --leads pointing to your CSV and --variants pointing to your variants.yaml, with SMARTLEAD_API_KEY set. The script creates the campaign, saves sequences, attaches tagged inboxes, and uploads leads in batches of 100.

What columns does the Smartlead leads CSV require?

The CSV must include email, first_name, last_name, and company_name. Optional allowed columns are company_domain, title, linkedin_url, situation_line, value_line, and cta_line; any other column causes the script to abort.

Does the script automatically start the Smartlead campaign?

No, the script always creates the campaign in DRAFT status and never activates it. You review subject lines, inbox assignments, leads, and schedule in the Smartlead UI, then press Start manually.

Why does the upload fail with no inboxes found for a tag?

The script filters email accounts by the tag specified in variants.yaml and requires healthy, non-warmup-blocked inboxes. If none match, tag your inboxes first using the smartlead-inbox-manager skill before uploading.

What are the limits of the Smartlead upload script?

It is tested up to 10,000 leads and includes retry with exponential backoff for rate limits, but larger lists may hit API throttling. The built-in YAML parser also does not support anchors, multi-line strings, or flow-style maps.