> 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?

This guide explains how to add your sending subdomain (for example hello.domain.com) to Google Postmaster Tools, and how to grant read access to Batch's team.

## Why This Matters

Google Postmaster Tools provides essential, Gmail-specific metrics for your top sending destination:

* Spam complaint rate
* SPF/DKIM/DMARC authentication
* TLS encryption
* And more

No other tool gives you this visibility: these metrics are unique to Postmaster Tool&#x73;**,** 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.**
* Access to the **DNS zone** for the domain in question (usually asking your backend team).
* The exact subdomains used for sending through Batch, e.g. hello.domain.com.
* The address to add with read access: [**deliverability@batch.com**](mailto:deliverability@batch.com)**.**

## Add and Verify your Subdomains

{% stepper %}
{% step %}

### Sign In

Sign in to postmaster.google.com with your company Google account to view all your email deliverability reports.

**Note**: Your company may have a shared Google account for Postmaster Tools. Use that account if one exists.
{% endstep %}

{% step %}

### Add a Subdomain

Click **Select a domain**, then choose **Manage domains** from the dropdown menu.

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FI7SalD8rPqMGB9P2BILu%2Fdeliverability_gptsetup1_010926.png?alt=media&amp;token=9c0f7d42-d3ee-4747-880f-942a48d4180e" alt=""><figcaption></figcaption></figure>

Then click **Add new domain** and type the subdomain name you want to add.

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FhASo3gHDxLtFU8TFK6z1%2Fdeliverability_gptsetup2_010926.png?alt=media&amp;token=fd0a70ec-2919-48cd-a2d2-cdbf9921b678" alt=""><figcaption></figcaption></figure>

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2F3SCMWWqWptryW28DYAkU%2Fdeliverability_gptsetup3_010926.png?alt=media&amp;token=f0a75165-b4a9-4fcf-81af-655025ab869d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Verify the Subdomain

Return to the Manage domains view. You will see your newly added subdomain. Click the three-dot menu next to it, then select **Verify**.

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2Fvqsnve5XpR61Ba1KgQWY%2Fdeliverability_gptsetup4_010926.png?alt=media&amp;token=a63bf3c4-df09-44f0-bc0a-25b27e8a7453" alt=""><figcaption></figcaption></figure>

You need to add a DNS record to verify you own the subdomain. Google Postmaster Tools supports two options. Use the **"CNAME" verification** option.

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FG7u1dL9ylc1MLahrkyNL%2Fdeliverability_gptsetup5_010926.png?alt=media&amp;token=91b55278-fc3a-481f-8491-7ff5f5f316dd" alt=""><figcaption></figcaption></figure>

Log in to the DNS management console for your domain with your host or DNS provider (OVH, Cloudflare, GoDaddy, etc.). Create the required record and save your changes. Then return to Postmaster Tools and click **Verify**.&#x20;

Verification is usually immediate, but can take a few hours depending on DNS propagation.
{% endstep %}

{% step %}

### Monitor Multiple Subdomains

To monitor additional subdomains, repeat these steps for each subdomain you want to monitor. We also recommend adding your root domain.
{% endstep %}
{% endstepper %}

{% 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 %}

## Share the Report with Batch

Sharing Postmaster Tools data with Batch's customer and deliverability team helps them support you better. Postmaster Tools reports do not contain personal data, such as recipient email addresses.

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FuhIj9ItfkK8Foho0xan9%2Fdeliverability_gptsetup6_010926.png?alt=media&amp;token=8f50109b-a7e6-480d-8545-df060209c616" alt=""><figcaption></figcaption></figure>

Once your subdomain is verified, you can invite others to view its dashboard. To do so:

1. On the Manage Domains page in Postmaster Tools, find your subdomain.
2. Click the three-dot menu (⋮) to the right of the domain name, then select **Manage users**.
3. Click the + button in the bottom-right corner of the window.
4. Enter the following address [**deliverability@batch.com**](mailto:deliverability@batch.com), then confirm.
5. Click **Done**. Access takes effect immediately.

{% 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 %}


---

# 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.
