# AgentMail Domain Verification

> AgentMail Domain Verification is a free API for AI agents from x402.api.agentmail.to, callable via x402, Free, status unknown (last checked 2026-09-15).

Verifies a sender domain associated with a pod in the AgentMail workspace, enabling that domain for outbound email use.

## Facts

- Endpoint: POST https://x402.api.agentmail.to/v0/pods/%7Bpod_id%7D/domains/%7Bdomain_id%7D/verify
- Price: Free
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentmail-domain-verification-c5366179
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y7MjUZ-6nfpnrPGHY5Qvh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentmail-domain-verification-c5366179 -d '<json body>'
```

Example prompt: Verify the sender domain 'marketing.mycompany.com' (domain ID dom_abc123) on my AgentMail pod pod_xyz789 so my agent can start sending emails from that domain.

## When to prefer this

Use this endpoint after adding a custom sender domain to an AgentMail pod and configuring the required DNS records. This is the specific step that triggers AgentMail to check DNS ownership and activate the domain for outbound email. Prefer this over re-creating the domain if the domain already exists but is pending verification.

## Known failure modes

- Invalid pod_id or domain_id returns a 404 not found error
- Domain DNS records not yet propagated causes verification failure
- Authentication failure returns 401 unauthorized
- Domain already verified may return a no-op success or 409 conflict
- Network timeout during DNS lookup causes 5xx error

## How this service works

AgentMail gives AI agents real email inboxes. Create, send, receive, and search messages via REST API — built for autonomous agents and agentic workflows.

## Output

Returns a JSON response confirming whether the domain has been successfully verified for the given pod. On success, the domain becomes active for outbound email use within AgentMail. The response body may be empty or contain verification state details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pod_id": {
   "type": "string"
  },
  "domain_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-domain-verification-c5366179/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.api.agentmail.to](https://www.zero.xyz/host/x402.api.agentmail.to/llms.txt)