Connect Google Postmaster to domain monitoring

Google Postmaster data adds available Gmail sender signals to your domain-monitoring investigation. Connect a Google account that can access the sending domain in Postmaster Tools, then review its available snapshots alongside DNS checks and inbox placement.

Connect your account

Open the Google Postmaster connection in MailSlurp's domain-monitoring area.
Start the Google authorization flow with the account that has access to your domain.
Complete the authorization and return to MailSlurp.
Check connection status and synchronize the domains.
Select the domain and synchronize its traffic statistics for the period you are investigating.

For a custom integration, create a connection URL, follow the returned OAuth flow and exchange the authorization code using the documented redirect configuration. Keep OAuth credentials and tokens on your server.

POST /domain-monitor/postmaster/connect

Create Postmaster OAuth connection URL

API reference Swagger UI operation

Request, parameters, and responses

Request body (required)

CreatePostmasterConnectionOptions application/json

Field	Type	Required
`redirectBase`	`string`	No
`redirectUri`	`string`	No
`emailAddress`	`string`	No
`state`	`string`	No

Request example

{
  "redirectBase": "value",
  "redirectUri": "value",
  "emailAddress": "user@example.com",
  "state": "value"
}

Responses

Status	Schema	Description
`201`	`CreatePostmasterConnectionResult`	Created

HTTP and SDK snippets

HTTP

POST /domain-monitor/postmaster/connect HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json
Content-Type: application/json

{
  "redirectBase": "value",
  "redirectUri": "value",
  "emailAddress": "user@example.com",
  "state": "value"
}

cURL

curl -X POST "https://api.mailslurp.com/domain-monitor/postmaster/connect" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{"redirectBase":"value","redirectUri":"value","emailAddress":"user@example.com","state":"value"}'

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);
const request = {
  "createPostmasterConnectionOptions": {
    "redirectBase": "value",
    "redirectUri": "value",
    "emailAddress": "user@example.com",
    "state": "value"
  }
};

const result = await domainMonitorPostmasterController.createDomainMonitorPostmasterConnection(request);

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    create_postmaster_connection_options = {
      "redirectBase": "value",
      "redirectUri": "value",
      "emailAddress": "user@example.com",
      "state": "value"
    }
    result = domainMonitorPostmasterController.create_domain_monitor_postmaster_connection(create_postmaster_connection_options)

POST /domain-monitor/postmaster/oauth-exchange

Exchange Postmaster OAuth authorization code

API reference Swagger UI operation

Request, parameters, and responses

Request body (required)

ExchangePostmasterCodeOptions application/json

Field	Type	Required
`authorizationCode`	`string`	Yes
`redirectUri`	`string`	Yes
`state`	`string`	Yes

Request example

{
  "authorizationCode": "value",
  "redirectUri": "value",
  "state": "value"
}

Responses

Status	Schema	Description
`201`	`PostmasterConnectionDto`	Created

HTTP and SDK snippets

HTTP

POST /domain-monitor/postmaster/oauth-exchange HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json
Content-Type: application/json

{
  "authorizationCode": "value",
  "redirectUri": "value",
  "state": "value"
}

cURL

curl -X POST "https://api.mailslurp.com/domain-monitor/postmaster/oauth-exchange" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{"authorizationCode":"value","redirectUri":"value","state":"value"}'

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);
const request = {
  "exchangePostmasterCodeOptions": {
    "authorizationCode": "value",
    "redirectUri": "value",
    "state": "value"
  }
};

const result = await domainMonitorPostmasterController.exchangeDomainMonitorPostmasterCode(request);

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    exchange_postmaster_code_options = {
      "authorizationCode": "value",
      "redirectUri": "value",
      "state": "value"
    }
    result = domainMonitorPostmasterController.exchange_domain_monitor_postmaster_code(exchange_postmaster_code_options)

GET /domain-monitor/postmaster/connection

Get Postmaster connection status

API reference Swagger UI operation

Request, parameters, and responses

Responses

Status	Schema	Description
`200`	`PostmasterConnectionStatusDto`	OK

HTTP and SDK snippets

HTTP

GET /domain-monitor/postmaster/connection HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json

cURL

curl -X GET "https://api.mailslurp.com/domain-monitor/postmaster/connection" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);

const result = await domainMonitorPostmasterController.getDomainMonitorPostmasterConnection();

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    result = domainMonitorPostmasterController.get_domain_monitor_postmaster_connection()

Synchronize and read statistics

Synchronization and reading are separate operations: the read endpoints return local snapshots. Check timestamps before treating a result as current.

POST /domain-monitor/postmaster/domains/sync

Sync Postmaster domains

API reference Swagger UI operation

Request, parameters, and responses

Responses

Status	Schema	Description
`200`	`PostmasterDomainDto[]`	OK

HTTP and SDK snippets

HTTP

POST /domain-monitor/postmaster/domains/sync HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json

cURL

curl -X POST "https://api.mailslurp.com/domain-monitor/postmaster/domains/sync" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);

const result = await domainMonitorPostmasterController.syncDomainMonitorPostmasterDomains();

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    result = domainMonitorPostmasterController.sync_domain_monitor_postmaster_domains()

GET /domain-monitor/postmaster/domains

List local Postmaster domain snapshots

API reference Swagger UI operation

Request, parameters, and responses

Responses

Status	Schema	Description
`200`	`PostmasterDomainDto[]`	OK

HTTP and SDK snippets

HTTP

GET /domain-monitor/postmaster/domains HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json

cURL

curl -X GET "https://api.mailslurp.com/domain-monitor/postmaster/domains" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);

const result = await domainMonitorPostmasterController.getDomainMonitorPostmasterDomains();

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    result = domainMonitorPostmasterController.get_domain_monitor_postmaster_domains()

POST /domain-monitor/postmaster/domains/{domain}/traffic-stats/sync

Sync Postmaster traffic stats

API reference Swagger UI operation

Request, parameters, and responses

Path parameters

Name	Type	Required	Description
`domain`	`string`	Yes

Query parameters

Name	Type	Required	Description
`startDate`	`string:date`	No
`endDate`	`string:date`	No

Responses

Status	Schema	Description
`200`	`PostmasterTrafficStatsListDto`	OK

HTTP and SDK snippets

HTTP

POST /domain-monitor/postmaster/domains/value/traffic-stats/sync?startDate=value&endDate=value HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json

cURL

curl -X POST "https://api.mailslurp.com/domain-monitor/postmaster/domains/value/traffic-stats/sync?startDate=value&endDate=value" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);
const request = {
  "domain": "value",
  "startDate": "value",
  "endDate": "value"
};

const result = await domainMonitorPostmasterController.syncDomainMonitorPostmasterTrafficStats(request);

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    result = domainMonitorPostmasterController.sync_domain_monitor_postmaster_traffic_stats("value", start_date="value", end_date="value")

GET /domain-monitor/postmaster/domains/{domain}/traffic-stats

Get local Postmaster traffic stats

API reference Swagger UI operation

Request, parameters, and responses

Path parameters

Name	Type	Required	Description
`domain`	`string`	Yes

Query parameters

Name	Type	Required	Description
`startDate`	`string:date`	No
`endDate`	`string:date`	No

Responses

Status	Schema	Description
`200`	`PostmasterTrafficStatsListDto`	OK

HTTP and SDK snippets

HTTP

GET /domain-monitor/postmaster/domains/value/traffic-stats?startDate=value&endDate=value HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json

cURL

curl -X GET "https://api.mailslurp.com/domain-monitor/postmaster/domains/value/traffic-stats?startDate=value&endDate=value" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);
const request = {
  "domain": "value",
  "startDate": "value",
  "endDate": "value"
};

const result = await domainMonitorPostmasterController.getDomainMonitorPostmasterTrafficStats(request);

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    result = domainMonitorPostmasterController.get_domain_monitor_postmaster_traffic_stats("value", start_date="value", end_date="value")

An empty domain list or missing day is not a healthy-sender verdict. Confirm the authorized account's domain access, connection state, requested period and last synchronization. Reporting availability can differ by domain and date; retain missing data as unknown.

Use the findings

Compare the same period across domain runs, placement tests and warmup activity. Change one sender variable at a time where practical and repeat the relevant test after a correction.

Disconnect the integration when the Google account should no longer provide data. Reconnect with an authorized account if credentials or access change.

DELETE /domain-monitor/postmaster/connection

Disconnect Postmaster OAuth

API reference Swagger UI operation

Request, parameters, and responses

Responses

Status	Schema	Description
`204`	`Response`	No Content

HTTP and SDK snippets

HTTP

DELETE /domain-monitor/postmaster/connection HTTP/1.1
Host: api.mailslurp.com
x-api-key: YOUR_API_KEY
Accept: application/json

cURL

curl -X DELETE "https://api.mailslurp.com/domain-monitor/postmaster/connection" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

JavaScript SDK

import { Configuration, DomainMonitorPostmasterControllerApi } from "mailslurp-client";

const config = new Configuration({ apiKey: "YOUR_API_KEY" });
const domainMonitorPostmasterController = new DomainMonitorPostmasterControllerApi(config);

const result = await domainMonitorPostmasterController.deleteDomainMonitorPostmasterConnection();

Python SDK

import mailslurp_client
from mailslurp_client.api.domain_monitor_postmaster_controller_api import DomainMonitorPostmasterControllerApi

configuration = mailslurp_client.Configuration()
configuration.api_key["x-api-key"] = "YOUR_API_KEY"

with mailslurp_client.ApiClient(configuration) as api_client:
    domainMonitorPostmasterController = DomainMonitorPostmasterControllerApi(api_client)
    result = domainMonitorPostmasterController.delete_domain_monitor_postmaster_connection()

Build with MailSlurp

Connect & learn

Connect Google Postmaster to domain monitoring

Connect your account

Synchronize and read statistics

Use the findings

The complete email and SMS toolkit.