> For the complete documentation index, see [llms.txt](https://doc.batch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.batch.com/guides-and-best-practices/email-deliverability/reputation-and-performance-monitoring/how-to-setup-google-postmaster-tools.md).

# How to Setup Google Postmaster Tools?

## Why This Matters

Google Postmaster Tools provides essential, Gmail-specific metrics - **spam complaint rate, SPF/DKIM/DMARC authentication, TLS encryption** - for your top sending destination. No other tool gives you this visibility: these metrics are **unique to Postmaster Tools**, and they're indispensable for monitoring your deliverability and reacting fast if something degrades.

## Prerequisites

* A **Google** or **Google Workspace** account (corporate or team-shared) to sign in to **Postmaster Tools V1**.
* Access to the **DNS zone** for the domain in question (usually asking your backend team).
* The exact subdomain used for sending through Batch, e.g. hello.domain.com.
* The address to add with read access: [**deliverability@batch.com**](mailto:deliverability@batch.com)**.**

{% hint style="warning" %}
Note that, due to technical limitations on Google’s side, this setup is only possible through the **Google Postmaster Tools V1** panel.
{% endhint %}

## Add and Verify your Root Domain in Postmaster Tools

1. Sign in at [**postmaster.google.com**](http://postmaster.google.com/) to access Postmaster Tools. Check the account you are using in the top right corner to be sure it’s the one you want to use to register your domain.

<figure><img src="/files/qNQq1Tv3HcWCO0cu1Ghp" alt=""><figcaption></figcaption></figure>

2. **Add your root domain** if it is not added to Google Postmaster Tools yet.

<figure><img src="/files/VTaB3WVYCTrP7OuBnOPU" alt=""><figcaption></figcaption></figure>

3. In the "Domain Verification" window, copy the TXT record value Google provides (it usually starts with google-site-verification=).

<figure><img src="/files/nUUh7Z72VdapsiO6HSiP" alt=""><figcaption></figcaption></figure>

4. Log in to the DNS management console for your subdomain (with your host or DNS provider: OVH, Cloudflare, GoDaddy, etc.).
5. Create a new TXT record, without removing your existing records. Save the change, then go back to Postmaster Tools and click Verify. Verification is usually immediate, but can take a few hours depending on DNS propagation.

## Add your Subdomain in Postmaster Tools

Your root domain is already added and verified. You can simply add your subdomains. The subdomain will appear in your domain list with a "Verified" status (it inherits your root domain verification).

<figure><img src="/files/NUpS5nNCmANxplOfzEaY" alt=""><figcaption></figcaption></figure>

Do not create a separate record on a subdomain level it can create **SPF verification issues**.

{% hint style="danger" %}
Only add the **TXT record on the root domain** - a TXT record can't coexist with a CNAME at the same name, so adding it on a CNAME'd subdomain **breaks SPF** even though Postmaster Tools shows it as verified.
{% endhint %}

{% hint style="info" %}
Traffic data won't appear in the dashboard until enough mail has been sent to Gmail addresses (typically 24 to 48 hours after verification, with a minimum sending volume). A successful verification with no visible data yet is not a problem in itself.
{% endhint %}

## Grant Batch Read Access

It's important to share this data with us so that Batch's customer team has everything they need to guide you properly. Please note that Postmaster Tools reports **do not expose any personal data**, such as recipient email addresses.\
Once the subdomain is verified, you can invite other people to view its dashboard. To do so:

1. From the **Manage Domains** page in Postmaster Tools, find the row for your subdomain.
2. Click the « ⋮ » (**More**) icon to the right of the domain name, then click Manage users.

<figure><img src="/files/pWfKqYkSDrtbw1FnAUXi" alt=""><figcaption></figcaption></figure>

3. Click the + button in the bottom-right corner of the window.

<figure><img src="/files/gem77eaLx7lPH5OR0KLa" alt=""><figcaption></figcaption></figure>

4. Enter the following address [**deliverability@batch.com**](mailto:deliverability@batch.com), then confirm.

<figure><img src="/files/IRiDq0F2qWkv5Nmlz6Sv" alt=""><figcaption></figcaption></figure>

5. Click **Done**. Access takes effect immediately.

<figure><img src="/files/NQHQXLL13Cj5PtyoVYzB" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Postmaster Tools **does not automatically** notify the person you add. Please let us know once access has been granted (by email or through your Batch contact) so our team can start monitoring. The access granted is **read-only**: Batch cannot modify or delete your configuration.
{% endhint %}

Sources :

* Google - [Set up Postmaster Tools (Gmail Help)](https://support.google.com/a/answer/9981691?hl=en) - official steps for domain setup, verification, and adding users
* Google - [Set up Postmaster Tools (Gmail Help)](https://support.google.com/a/answer/9981691?hl=en) - same page, covers "Manage users"
* Google Workspace Admin Community - [Set up Postmaster Tools on behalf of a client](https://support.google.com/a/thread/258862370/set-up-postmaster-tools-on-behalf-of-client?hl=en)
* Validity - [Post up with our guide to Google Postmaster Tools](https://www.validity.com/blog/post-up-with-our-guide-to-google-postmaster-tools/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.batch.com/guides-and-best-practices/email-deliverability/reputation-and-performance-monitoring/how-to-setup-google-postmaster-tools.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.