Deliverability test public skill

Compare reply rates, bounce rates, and positive reply rates broken down by inbox type (SMTP / Gmail / Outlook) for a Smartlead account.

by growthenginenowoslawski·MIT license·★ 736 Stars on the repo·GitHub ↗

Use now

Files of Deliverability test public

growthenginenowoslawski/main1 file shown
SKILL.md
Show the full text88 lines

Deliverability Test — Inbox Type Comparison

Compare reply rates, bounce rates, and positive reply rates broken down by inbox type (SMTP, Gmail / G Suite, Outlook / Office365) across your Smartlead account. Use it to answer "are my Gmail inboxes performing better than my SMTP ones?" or "why is one inbox type bouncing more than the others?"

Why this exists

Different inbox types have different deliverability characteristics:

  • Gmail / G Suite — highest trust, fewest bounces, often best reply rates
  • Office365 — good reputation, but stricter spam filtering
  • SMTP (Zapmail, Maildoso, Mailforge, custom) — varies wildly by provider, often has higher bounces in the first 30 days of domain life

If your campaigns mix inbox types, this skill shows which type is earning its keep.

What you need

  • SMARTLEAD_API_KEY in env
  • Optional: --client-id=<id> for sub-clients
  • Optional: --days=<N> lookback (default 7)

Steps

# Full account, last 7 days
npx tsx scripts/inbox-type-compare.ts

# Specific sub-client, 14-day lookback
npx tsx scripts/inbox-type-compare.ts --client-id=5560 --days=14

# Just show today
npx tsx scripts/inbox-type-compare.ts --days=1

Output

Inbox Type Comparison — last 7 days

Type              Inboxes    Sent     Replies   Bounces    Reply %   Bounce %
---------------   ------   -------   -------   -------    -------   --------
G Suite               12    3,120       42        12        1.35%      0.38%
Office365             24    6,440       65        28        1.01%      0.43%
SMTP                  44   10,780       55        98        0.51%      0.91%
---------------   ------   -------   -------   -------    -------   --------
TOTAL                 80   20,340      162       138        0.80%      0.68%

Takeaways:
- G Suite has the highest reply rate (1.35%) and lowest bounce rate.
- SMTP reply rate is 60% lower than G Suite — investigate domain reputation.
- SMTP bounce rate is 2x average — run /email-deliverability-audit on SMTP domains.

How it works

  1. Pulls all email accounts via /email-accounts API paginated
  2. Groups by type field (GMAIL, OUTLOOK, SMTP, etc.)
  3. For each campaign that uses these inboxes, pulls per-inbox stats from /campaigns/{id}/analytics and /campaigns/{id}/sequence-analytics-by-email-account
  4. Aggregates sent/replies/bounces within each type group
  5. Prints formatted table

Common gotchas

  • Reply rate here is RAW, not positive. For positive reply rate (the more important metric), use /positive-reply-scoring.
  • Small inbox counts are noisy. If you only have 2 Gmail inboxes and 40 SMTP ones, the Gmail numbers aren't statistically meaningful.
  • Inbox type labels can be surprising. Some providers register as "SMTP" even when they're technically Gmail-proxied. Trust the label Smartlead gave them.

What to do next

If one inbox type is underperforming: /smartlead-inbox-manager to retire the bad ones (tag retired, disable warmup). If replacements are needed, /zapmail-domain-setup-public to provision new domains on a different provider type.

If all types are healthy: back to the weekly rhythm via /cold-email-weekly-rhythm.

Or wait: small sample sizes (<500 sends per type) are noisy. If your results are inconclusive, run again in 7 days with more data.

  • /email-deliverability-audit — full audit (SPF/DKIM/DMARC + reputation + spam placement)
  • /positive-reply-scoring — the metric that matters, not just reply rate
  • /smartlead-inbox-manager — rotate out bad inboxes, tag by performance

Scripts

  • scripts/inbox-type-compare.ts — pulls + compares per-type rates
1---
2name: deliverability-test-public
3description: Compare reply rates, bounce rates, and positive reply rates broken down by inbox type (SMTP / Gmail / Outlook) for a Smartlead account. Use when you want to know "which inbox type delivers best" or when debugging unexplained deliverability differences across a mixed fleet. Operates via Smartlead API only (no database required).
4---
5 
6# Deliverability Test — Inbox Type Comparison
7 
8Compare reply rates, bounce rates, and positive reply rates broken down by inbox type (SMTP, Gmail / G Suite, Outlook / Office365) across your Smartlead account. Use it to answer "are my Gmail inboxes performing better than my SMTP ones?" or "why is one inbox type bouncing more than the others?"
9 
10## Why this exists
11 
12Different inbox types have different deliverability characteristics:
13- **Gmail / G Suite** — highest trust, fewest bounces, often best reply rates
14- **Office365** — good reputation, but stricter spam filtering
15- **SMTP** (Zapmail, Maildoso, Mailforge, custom) — varies wildly by provider, often has higher bounces in the first 30 days of domain life
16 
17If your campaigns mix inbox types, this skill shows which type is earning its keep.
18 
19## What you need
20 
21- `SMARTLEAD_API_KEY` in env
22- Optional: `--client-id=<id>` for sub-clients
23- Optional: `--days=<N>` lookback (default 7)
24 
25## Steps
26 
27```bash
28# Full account, last 7 days
29npx tsx scripts/inbox-type-compare.ts
30 
31# Specific sub-client, 14-day lookback
32npx tsx scripts/inbox-type-compare.ts --client-id=5560 --days=14
33 
34# Just show today
35npx tsx scripts/inbox-type-compare.ts --days=1
36```
37 
38## Output
39 
40```
41Inbox Type Comparison — last 7 days
42 
43Type Inboxes Sent Replies Bounces Reply % Bounce %
44--------------- ------ ------- ------- ------- ------- --------
45G Suite 12 3,120 42 12 1.35% 0.38%
46Office365 24 6,440 65 28 1.01% 0.43%
47SMTP 44 10,780 55 98 0.51% 0.91%
48--------------- ------ ------- ------- ------- ------- --------
49TOTAL 80 20,340 162 138 0.80% 0.68%
50 
51Takeaways:
52- G Suite has the highest reply rate (1.35%) and lowest bounce rate.
53- SMTP reply rate is 60% lower than G Suite — investigate domain reputation.
54- SMTP bounce rate is 2x average — run /email-deliverability-audit on SMTP domains.
55```
56 
57## How it works
58 
591. Pulls all email accounts via `/email-accounts` API paginated
602. Groups by `type` field (GMAIL, OUTLOOK, SMTP, etc.)
613. For each campaign that uses these inboxes, pulls per-inbox stats from `/campaigns/{id}/analytics` and `/campaigns/{id}/sequence-analytics-by-email-account`
624. Aggregates sent/replies/bounces within each type group
635. Prints formatted table
64 
65## Common gotchas
66 
67- **Reply rate here is RAW, not positive.** For positive reply rate (the more important metric), use `/positive-reply-scoring`.
68- **Small inbox counts are noisy.** If you only have 2 Gmail inboxes and 40 SMTP ones, the Gmail numbers aren't statistically meaningful.
69- **Inbox type labels can be surprising.** Some providers register as "SMTP" even when they're technically Gmail-proxied. Trust the label Smartlead gave them.
70 
71## What to do next
72 
73**If one inbox type is underperforming:** `/smartlead-inbox-manager` to retire the bad ones (tag `retired`, disable warmup). If replacements are needed, `/zapmail-domain-setup-public` to provision new domains on a different provider type.
74 
75**If all types are healthy:** back to the weekly rhythm via `/cold-email-weekly-rhythm`.
76 
77**Or wait:** small sample sizes (<500 sends per type) are noisy. If your results are inconclusive, run again in 7 days with more data.
78 
79## Related skills
80 
81- `/email-deliverability-audit` — full audit (SPF/DKIM/DMARC + reputation + spam placement)
82- `/positive-reply-scoring` — the metric that matters, not just reply rate
83- `/smartlead-inbox-manager` — rotate out bad inboxes, tag by performance
84 
85## Scripts
86 
87- `scripts/inbox-type-compare.ts` — pulls + compares per-type rates
88 

Discussion

Alternatives