smartlead-inbox-manager

Configure Smartlead inbox warmup, signatures, tags, and health monitoring via API scripts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing hundreds of cold-email inboxes in Smartlead by hand is slow and error-prone: each inbox needs warmup enabled with the right ramp, a signature applied, tags for active vs insurance status, and ongoing health monitoring. This Skill automates all of that through the Smartlead API. ## Core Features & Use Cases - Bulk Warmup Control: Enable warmup with a configurable ramp (e.g. 40/day, +5/day), disable it for active senders, or apply a low-volume maintenance mode for insurance inboxes. - Bulk Signature Setting: Apply a plain-text signature template with placeholders like {from_name}, {title}, {company}, and {address} across selected inboxes, keeping a real mailing address in every footer. - Tag Management: Add or remove tags (active, insurance, retired) so inbox pools stay organized at scale. - Health Dashboard: Generate a CSV and console summary of warmup status, reputation, daily sends, and blocked inboxes with action items. - Use Case: After provisioning 80 new inboxes, run one command to enable warmup on all of them, set signatures, tag them as insurance, then run a weekly health check to catch blocked or bad-reputation inboxes before they hurt a campaign. ## Quick Start Set the SMARTLEAD_API_KEY environment variable and ask the assistant to enable warmup with the default ramp on all newly tagged inboxes, then show the health dashboard.

Frequently Asked Questions about smartlead-inbox-manager

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

FAQPage Schema
How do I enable warmup on multiple Smartlead inboxes at once?

Run scripts/set-warmup.ts with --mode=enable and a selector like --all, --tag=new, or --ids=1,2,3. The script loops through each inbox and posts warmup settings (default 40/day with a ramp of 5) using 5 concurrent requests.

How to set email signatures in bulk in Smartlead?

Use scripts/set-signatures.ts with an inbox selector. It applies a default template of name, title, company, and address pulled from SENDER_* environment variables, or you can pass a custom template with --template or --template-file using placeholders like {from_name} and {address}.

What warmup settings should new cold email inboxes use?

The recommended config for new inboxes is warmup enabled, 40 emails per day maximum, a daily rampup of 5, and a 20% reply rate. Insurance inboxes use a lower maintenance mode of 15 per day with no ramp, and active inboxes have warmup disabled.

Does Smartlead support removing tags from inboxes via API?

Smartlead's tag endpoint replaces the entire tag list rather than deleting individual tags. The tag-inboxes.ts script handles this by reading existing tags, filtering out the one to remove, and posting the full updated list back.

Why is my Smartlead inbox warmup blocked?

An inbox shows is_warmup_blocked as true when Smartlead flags it, usually for spam-like behavior in the warmup network. The health dashboard surfaces blocked inboxes as action items, and they require manual investigation or replacement.

When should I retire a cold email inbox?

Retire an inbox when its overall reply rate falls below 1% after sending 200 or more emails, which indicates it is burned or has poor deliverability. Tag it as retired, remove the active tag, and disable warmup.