# Gmail Postmaster Tools Walkthrough — IP Reputation for AcelleMail Senders

> Google Postmaster Tools is free. It shows your Gmail-side spam rate, IP reputation, domain reputation, and authentication pass rates. This guide walks the signup, the daily-check routine, and how to wire findings back into AcelleMail.

- Canonical URL: https://acellesend.com/kb/articles/gmail-postmaster-tools-walkthrough
- Author: Lena Hart, Email Deliverability Editor
- Category: Sending & Deliverability — SMTP setup, bounce handling, sender reputation, IP warmup, throttling
- Content type: tutorial · Difficulty: intermediate
- Tags: Acellemail
- Published: 2026-07-04 · Last updated: 2026-08-15
- Reading time: 6 min
- Publisher: AcelleMail Knowledge Base, https://acellesend.com/kb

---

## Why Postmaster Tools

Gmail handles ~30% of consumer email globally and ~50% of business email. Their reputation engine is the most influential signal in your deliverability score. Google Postmaster Tools (free) shows:

| Signal | What it tells you |
|---|---|
| **Spam rate** | % of your mail Gmail users marked as Spam |
| **IP reputation** | Google's verdict on your sending IPs (High / Medium / Low / Bad) |
| **Domain reputation** | Google's verdict on your sending domain (same scale) |
| **Authentication** | Per-day SPF / DKIM / DMARC pass rates |
| **Encryption** | TLS adoption % on outbound mail |
| **Delivery errors** | Rate-limit / temp-fail / permanent-fail breakdowns |
| **Feedback loop** | Spam-trap hits (rare, severe signal) |

## Sign up + verify your domain

### Step 1: Go to postmaster.google.com

URL: https://postmaster.google.com

Click **Get started** → Google account login.

### Step 2: Add your sending domain

Click **+ Add domain**. Enter the domain you send from (e.g. `mail.example.com`).

Google shows a TXT record to add at your DNS host. Add it; click **Verify**.

Within ~5 minutes (often immediate), domain verified.

### Step 3: Wait for data

Google starts collecting Gmail-side signals from the moment you verify. Dashboard becomes populated within 24-48 hours.

If sends are <1,000/day to Gmail addresses, Google may not show meaningful data — too low a sample size. The threshold is ~1,000 Gmail recipients per day before Postmaster Tools generates meaningful panels.

## The 5 panels to check daily

### Panel 1: Spam rate

The most important signal. Daily plot of % users marked as Spam.

| Spam rate | Verdict |
|---|---|
| <0.1% | Excellent — well below Google's threshold |
| 0.1-0.3% | Healthy |
| 0.3-1% | Warning — investigate this week |
| >1% | Critical — Gmail starts throttling immediately |

Action on spike: pause sending; audit content + list; investigate consent. Recovery cycle = 2-4 weeks typically.

### Panel 2: IP reputation

Per-IP rating, one entry per IP you send from.

| Rating | What it means |
|---|---|
| **High** | Most reliable; full inbox delivery |
| **Medium** | Most mail inboxes; some routed to Junk |
| **Low** | Significant Junk routing |
| **Bad** | Most mail to Junk; possibly blocked |

If you see Bad on a fresh IP, expected during warmup — should climb to Medium → High over 2-4 weeks. If Bad on a mature IP, something broke — audit recent campaigns + bounce log.

### Panel 3: Domain reputation

Aggregate across all IPs that send from this domain. Slower to change than IP reputation; reflects long-term pattern.

### Panel 4: Authentication

Per-day SPF/DKIM/DMARC pass rates. Should be >99%. <95% means something's broken — re-verify domain in AcelleMail:

![AcelleMail sending-server with auth chips](https://acellesend.com/plugins/acelle/landing/images/help/kb/spam-folder/02-sending-server-config.png)

Each chip should show Green. Click *Verify domain* if any are Red.

### Panel 5: Delivery errors

Breakdown of bounces by error type. Useful for comparing Postmaster Tools' Gmail-specific view with AcelleMail's all-recipient bounce log:

![Campaign bounce log](https://acellesend.com/plugins/acelle/landing/images/help/kb/campaign-delivery/02-campaign-bounce-log.png)

If Postmaster shows 5% Gmail-specific errors but AcelleMail shows 1% overall, the issue is Gmail-side specifically — Gmail rate-limiting, Gmail reputation hit, etc.

## Daily-check action matrix

| Postmaster signal | AcelleMail action |
|---|---|
| Spam rate jumps from 0.05% → 0.15% | Audit yesterday's campaign content; pause if not obvious; check signup consent |
| IP reputation flips from High → Medium | Hold current volume; investigate possible reputation drop sources |
| IP reputation hits Bad | Pause that server; ramp-down volume; investigate root cause |
| Domain reputation drops | Slower-moving — usually weeks of degraded sends; bigger investigation needed |
| Authentication pass rate drops to <95% | Re-verify domain in AcelleMail; check DNS records |
| Spam-trap hit count >0 | List source has dead addresses or purchased data — audit imports |
| Delivery error spike (4.x retry) | Greylisting — wait 30 min; AcelleMail handles retry |

## Postmaster Tools confusion fixes

| What you see | What it actually means |
|---|---|
| "No data" panels after Day 7 | Your Gmail volume too low for meaningful aggregation; or domain not properly verified |
| Spam rate higher than expected even though bounce rate is fine | Spam rate = users-marked-as-spam (NOT bounce). High spam rate means content/list issue, not deliverability |
| IP reputation Bad despite high engagement | Your IP is shared with another sender who's getting complaints — request dedicated IP from vendor |
| Domain reputation Bad despite IP reputation High | Different IPs sending from your domain (one bad actor mixing); audit who else sends from this domain |
| Authentication < 95% | DKIM signature failing — check DKIM key matches DNS published record |

<details>
<summary><strong>Advanced: programmatic polling, daily-alert pipelines, and Bad-reputation recovery</strong></summary>

Postmaster Tools doesn't have a public API. Workaround: web-scraping or screen-scraping daily.

**Scraping pattern:**

Use Playwright or Puppeteer + a service account with Postmaster access:

```javascript
// daily-postmaster-scrape.mjs
import { chromium } from 'playwright';
const b = await chromium.launch();
const ctx = await b.newContext({ storageState: 'postmaster-auth.json' });
const page = await ctx.newPage();
await page.goto('https://postmaster.google.com');
const spamRate = await page.locator('.spam-rate-value').textContent();
const ipRep = await page.locator('.ip-reputation-row .rating-chip').first().textContent();
// ... POST to your monitoring system
```

Authenticate once interactively (creates `postmaster-auth.json`); subsequent runs are headless.

**Daily-alert pipeline:**

```
postmaster-scrape → metrics-collector → alert-on-threshold-cross
```

Pipe scraped metrics to Datadog / Grafana / Sentry. Threshold-based alerts:

- Spam rate > 0.2% → page on-call
- IP reputation Bad → page + auto-pause server in AcelleMail
- Auth pass rate < 95% → page

**Bad-reputation recovery cycle:**

When IP reputation hits Bad:

```
Day 0:  AUTO-PAUSE the affected sending server in AcelleMail
        Audit yesterday's campaigns from this server
        Identify root cause (content / consent / volume spike)
Day 1:  Send small volume (~500) ONLY to engaged-last-7d
        Monitor next 24h spam rate / inbox placement
Day 7:  If sustained healthy signals, expand to engaged-last-30d at 30% volume
Day 14: Expand to engaged-last-90d at 60%
Day 21: Resume full volume if reputation back to Medium/High
```

Recovery from Bad takes 3-6 weeks typically. Sometimes irrecoverable — need fresh IP + warmup cycle.

**Comparing Gmail-specific vs aggregate:**

AcelleMail's bounce log + Postmaster Tools = two views of the same delivery reality. Cross-reference:

```bash
# Get AcelleMail's last-24h Gmail-only stats
acelle_gmail_bounces=$(curl -sH "Authorization: Bearer $TOKEN" \
  "https://acellemail.com/api/v1/admin/bounces?domain=gmail.com&since=24h" \
  | jq '.total')

# Compare with Postmaster Tools delivery error count for same period
postmaster_gmail_errors=$(get_from_postmaster_scrape)

# Significant divergence → investigate
if [ $(( acelle_gmail_bounces / postmaster_gmail_errors )) -gt 3 ]; then
  echo "AcelleMail seeing 3x more Gmail bounces than Postmaster reports — audit"
fi
```

When AcelleMail's count significantly exceeds Postmaster's, your DNS attribution may be broken (mail not getting properly attributed to your domain). Investigate.

**Setting up postmaster for sub-domains:**

If you send marketing from `mail.example.com` and transactional from `txn.example.com`, verify EACH subdomain separately. Per-subdomain reputation = isolated. Helps prevent marketing reputation hits from poisoning transactional delivery.

**JMRP (Junk Email Reporting Program)** for Outlook is the Microsoft equivalent — separate signup. See [Microsoft SNDS walkthrough](https://acellesend.com/kb/articles/microsoft-snds-walkthrough).

</details>

## Related articles

- [Sender reputation monitoring](https://acellesend.com/kb/articles/sender-reputation-monitoring)
- [Microsoft SNDS walkthrough](https://acellesend.com/kb/articles/microsoft-snds-walkthrough)
- [IP warmup schedule for new sending servers](https://acellesend.com/kb/articles/ip-warmup-schedule-for-new-sending-servers)
- [Deliverability incident runbook](https://acellesend.com/kb/articles/deliverability-incident-runbook)
- [Why are my emails going to spam folder](https://acellesend.com/kb/articles/why-are-my-acellemail-emails-going-to-spam-folder)

---

## Related articles

- [Feedback Loops (FBL) — Setup + Wire in AcelleMail](https://acellesend.com/kb/articles/feedback-loops-fbl-setup): When a recipient clicks "Mark as Spam" on a Microsoft / Yahoo / AOL / Comcast mailbox, those ISPs send you the complaint via Feedback Loop. AcelleMail processes it automatically — unsubscribes the complainer, updates the complaint stats. This guide walks the setup.
- [How to Set Up Amazon SES with AcelleMail](https://acellesend.com/kb/articles/configuring-amazon-ses-with-acellemail): Create an IAM user and access key in AWS, connect Amazon SES to AcelleMail, share your verified domains with users, and let them verify their own.
- [Amazon SES Sending Limits — Cookbook for AcelleMail Operators](https://acellesend.com/kb/articles/ses-sending-limits-cookbook): SES starts at 200/day sandbox, scales to 50k+/day in production, $0.10 per 1,000 emails. This guide is the practical cookbook: how to grow from sandbox to scale, region-by-region orchestration, what AcelleMail does at each tier.
- [Multiple Sending Servers in AcelleMail — Add, Mix, Route](https://acellesend.com/kb/articles/configuring-multiple-sending-servers): Spread your volume across several SMTP and API senders for failover, reputation isolation, and headroom past any single vendor's cap. This guide walks the real screens: the type picker, the connect form, the per-campaign "Use all servers" toggle, and the admin pool view.
- [Hard Bounce vs Soft Bounce — Reading the Bounce Log](https://acellesend.com/kb/articles/understanding-email-bounce-types): A hard bounce is permanent; a soft bounce is temporary. AcelleMail records them in the campaign bounce log and treats them differently — hard bounces blacklist the address, soft bounces are left alone for the receiving server to retry. This guide walks the bounce log, the DSN codes, and what each type means for your list.