Check a domain connection

Look for the connection's TXT record now instead of on the next automatic check. A record that is not there yet is not an error: `last_check` says what was found instead.

POSThttps://app.trygtm.com/api/v1/domains/connections/{connection_id}/checks

Scope: write
MCP tool: check_domain_connection

Path parameters

connection_idstringrequired: The connection's id, from connect_domain or list_domain_connections.

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Request

curl -X POST https://app.trygtm.com/api/v1/domains/connections/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/checks \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Response

{
  "data": {
    "id": "5c6d7e8f-9012-4a3b-8c4d-5e6f70819203",
    "name": "acme-outreach.com",
    "status": "awaiting_nameservers",
    "domain_id": "2b3c4d5e-6f70-4a81-9b2c-3d4e5f607182",
    "verification": {
      "type": "TXT",
      "host": "_trygtm-verification",
      "name": "_trygtm-verification.acme-outreach.com",
      "value": "trygtm-verification=3f9c2a7d41b8e05c6a9d2f7e1b4c8a03d5e6f7a8b9c0d1e2"
    },
    "last_check": null,
    "nameservers": [
      "ada.ns.example.net",
      "bob.ns.example.net"
    ],
    "existing_mail_hosts": [],
    "error": null,
    "expires_at": "2026-10-06T09:58:00.000Z",
    "created_at": "2026-09-22T09:40:00.000Z"
  }
}