# Warmup Mailboxes

> Apply a verified production-grade warmup configuration to one or many Smartlead mailboxes. Sets the golden config (1 → 20 ramp, 60% reply rate, 15 send/day, weekday warmups). Use when the user has new mailboxes that need to be warmed up, when they're seeing poor inbox placement on a mature mailbox, or when they ask about "warmup settings" / "golden config" / "best practices for warmup".

- **Type:** Skill
- **Install:** `agentstack add skill-mattsezgin-unofficial-smartlead-cli-warmup-mailboxes`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MattSezgin](https://agentstack.voostack.com/s/mattsezgin)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [MattSezgin](https://github.com/MattSezgin)
- **Source:** https://github.com/MattSezgin/unofficial-smartlead-cli/tree/main/.claude/skills/warmup-mailboxes
- **Website:** https://github.com/MattSezgin/unofficial-smartlead-cli

## Install

```sh
agentstack add skill-mattsezgin-unofficial-smartlead-cli-warmup-mailboxes
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

> **Before running:** verify exact flag names with `smartlead  --help`. Flag shapes shown below are illustrative — confirm against the actual CLI.

# /warmup-mailboxes

You're configuring warmup on one or more Smartlead mailboxes using a verified production-grade config.

## What you need from the user

- **Mailbox IDs** — comma-separated, or a tag/client filter
- **Warmup pool key** — a 5-letter-prefix-5-letter-suffix tag like `acme1-pool1` (groups mailboxes that warm up together)
- Optionally: client_id if the mailboxes need to be assigned to a Smartlead client record

Ask for these if not provided.

## The golden config we'll apply

Verified for Gmail mailboxes. Before applying, check the mailbox `type` — if it's not `GMAIL`, pause and ask the user how they want to proceed.

```
message_per_day: 15           # not 20 — leave buffer for warmup
warmup_enabled: true
warmup_min_count: 1
warmup_max_count: 20
daily_rampup: 5               # 1 → 6 → 11 → 16 → 20 over 5 days
reply_rate: 60                # 60% reply rate from warmup network
auto_adjust_warmup: false     # manual control beats automatic
send_warmups_only_on_weekdays: true
use_custom_domain: false      # OFF during warmup, turn on week 4+
daily_reply_limit: 5
```

**Why these values:** see `docs/learnings/mailbox-warmup-best-practices.md`.

## How to run it

### For a single mailbox

```bash
smartlead accounts warmup  --enable \
  --daily 20 --rampup 5 --reply-rate 60 \
  --warmup-key 
```

### For many mailboxes (uses the internal bulk endpoint)

```bash
smartlead accounts bulk-update \
  --ids ,, \
  --message-per-day 15 \
  --warmup-status ENABLED \
  --warmup-min 1 \
  --warmup-max 20 \
  --rampup-value 5 \
  --reply-rate 60 \
  --warmup-key  \
  --send-warmups-only-on-weekdays
```

### Filter by tag (if mailboxes are pre-tagged)

```bash
# Find IDs by tag
smartlead accounts tags get --tag  --output json | jq -r '.[].id' > ids.txt

# Then bulk-update
smartlead accounts bulk-update --ids-file ids.txt ...
```

## After warming up

After ~3 weeks of clean warmup, the mailbox is ready for production. At that point:

```bash
# Turn on custom-domain tracking (was off during ramp)
smartlead accounts bulk-update --ids  --use-custom-domain
```

## Verification

```bash
smartlead accounts get  --output json | jq '.warmup_details'
```

Should show:
- `warmup_enabled: true`
- `total_warmup_per_day: 20`
- `warmup_min_count: 1`
- `warmup_max_count: 20`
- `daily_rampup: 5`
- `warmup_key_id: ""`

## Notes

- The public warmup API enforces `daily_rampup >= 5`. To use lower rampup values you must use the internal bulk endpoint (which the `bulk-update` command uses by default).
- `warmup_key_id` controls which mailboxes pool together for warmup. Pick keys deliberately — see `docs/learnings/warmup-key-id-format.md`.
- For a deep dive on why send 15 (not 20) and why weekday-only, see `docs/learnings/mailbox-warmup-best-practices.md`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [MattSezgin](https://github.com/MattSezgin)
- **Source:** [MattSezgin/unofficial-smartlead-cli](https://github.com/MattSezgin/unofficial-smartlead-cli)
- **License:** MIT
- **Homepage:** https://github.com/MattSezgin/unofficial-smartlead-cli

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mattsezgin-unofficial-smartlead-cli-warmup-mailboxes
- Seller: https://agentstack.voostack.com/s/mattsezgin
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.