smartlead-inbox-manager

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

Updated May 28, 2025
One-click install
npx skills add https://github.com/meloShaya/insteltech --skill smartlead-inbox-manager-meloshaya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smartlead-inbox-manager
Source: https://github.com/meloShaya/insteltech/tree/main/crm/library/skills/smartlead-inbox-manager
Command: npx skills add https://github.com/meloShaya/insteltech --skill smartlead-inbox-manager-meloshaya

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 tracking 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 ramp (1/day growing by 5/day up to 40/day), disable it for active senders, or apply a low-volume maintenance mode for insurance inboxes. - Bulk signature setting: Apply a templated signature (name, title, company, physical address) across selected inboxes, with per-inbox persona support via the inbox's from_name field. - Tag management: Add or remove tags like active, insurance, or retired across inbox batches selected by ID, domain, tag, or CSV. - 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 the Day 1 workflow to enable warmup, set signatures, and tag them as insurance, then run a weekly health check to catch blocked or bad-reputation inboxes before they hurt campaigns. ## Quick Start Set the SMARTLEAD_API_KEY environment variable and ask the assistant to enable warmup with the standard ramp on all newly tagged inboxes, then apply signatures and tag them as insurance.

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, --domain, or --ids. It applies a ramp of 1 email per day growing by 5 daily up to 40 per day, with a 20% reply rate, across all matched inboxes.

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 physical address pulled from SENDER_* environment variables, or a custom template passed via --template or --template-file with placeholders like {from_name} and {company}.

What is the difference between active and insurance inboxes in Smartlead?

Active inboxes send in live campaigns with warmup disabled so the daily budget goes to real prospects. Insurance inboxes stay warmed at low volume (15/day, no ramp) as reserves, ready to swap in when an active inbox burns out.

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, applying the add or remove change, and posting the full updated list.

When should I retire a Smartlead inbox?

Retire an inbox when its overall reply rate falls below 1% after sending 200 or more emails, or when the health dashboard shows blocked status or bad reputation. Tag it as retired and disable warmup before replacing it.

Why is my Smartlead inbox warmup blocked?

A blocked warmup (is_warmup_blocked: true) means Smartlead flagged the inbox, usually for spam-like behavior in the warmup network. The health dashboard surfaces these inboxes, but unblocking requires manual investigation in Smartlead.