Connect Letterhead to Google Postmaster

Overview

Gmail keeps a running verdict on whether it trusts your mail — how often readers mark you as spam, how much it trusts your sending domain, and whether your mail authenticates. Normally you’d only see it by setting up Google Postmaster Tools and going to read it in Google’s dashboard.

Connecting Google Postmaster to Letterhead brings that verdict in for you. You sign in once, and Gmail’s view of each of your sending domains appears next to the sending it’s judging — no copying numbers out of Google.

The connection is read-only: Letterhead only reads what Google Postmaster reports. It never changes anything in your Google account.

Before you start

• Your sending domains need to be set up in Google Postmaster Tools first. Letterhead pulls in the domains registered under the Google account you connect with — it can’t see a domain that hasn’t been added and verified at postmaster.google.com. If you haven’t done that yet, set it up there before connecting.
• Sign in with the Google account that has that Postmaster access — the one where your domains are registered.
• Connecting integrations is an administrator task. If you don’t see the option, ask a company administrator.

How to connect

1. Go to Integrations in your company settings.
2. Find the Google Postmaster card — “See how Gmail rates your sending, without leaving Letterhead” — and open it.
3. Choose Connect.
4. Google asks you to approve read-only access to your Postmaster data. Approve it, and you’re returned to Letterhead with the connection made.

What you’ll see

Once connected, each of your sending domains gets its own card with Gmail’s signals for it:

• Spam rate — how often Gmail readers mark your mail as spam. The single most important number; keep it well under 0.1%.
• Gmail reputation — how much Gmail trusts the domain, from High down to Bad.
• Authentication — your SPF, DKIM, and DMARC pass rates, so you can see whether Gmail can verify your mail is really from you.
• Delivery errors — the reasons Gmail gave for holding back or rejecting mail, shown only when it reported any.
• Spam rate trend — how your complaint rate has moved over recent days, so you can spot a climb before it becomes a problem.

When a signal is at risk, the card adds a plain-language Recommended next step telling you what to change — not just that something is off.

To pull the latest signals at any time, choose Refresh now. Gmail’s numbers update about once a day, so there’s rarely a reason to refresh more often than that.

What to expect at first

Gmail doesn’t publish everything for every domain right away, so a new or low-volume connection can look sparse for a while. That’s normal:

• A brand-new domain may show nothing yet. Gmail needs “a few days of steady sending first” before it publishes anything for a domain.
• Authentication shows before spam rate and reputation. Gmail reports SPF, DKIM, and DMARC at fairly low volume, but only starts publishing a spam rate and a reputation once a domain sends enough mail to Gmail to measure them. So it’s normal to see your authentication rates while spam rate and reputation are still blank.
• Each signal shows the most recent day Gmail actually reported it. Because Gmail skips a signal on days a domain sends too little, the card looks back over recent days rather than showing a dash for a value it published only a day or two ago.

If the panel says no sending domains are being monitored yet, the account you connected doesn’t have any domains set up in Google Postmaster Tools — add and verify them at postmaster.google.com, then refresh.

Disconnecting

To stop pulling Gmail’s signals, open the Google Postmaster card and choose Disconnect. Because the connection was read-only, disconnecting simply stops the sync — nothing in your Google account is affected.