# AgentMail Create Domain

> AgentMail Create Domain is a paid API for AI agents from AgentMail at mpp.api.agentmail.to, $10/call, status unknown (last checked 2026-10-12).

Registers a custom email domain within an AgentMail pod, returning DNS verification records needed to activate it

## Facts

- Endpoint: POST https://mpp.api.agentmail.to/v0/pods/:pod_id/domains?utm_source=zero.xyz
- Price: $10/call
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-domains-15d268fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bvOpiz0xUCp2I1SSh00wW

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-domains-15d268fd -d '<json body>'
```

Example prompt: Register the domain 'myagents.io' in my AgentMail pod and enable bounce and complaint feedback notifications so I can start setting up agent inboxes under it.

## When to prefer this

Use this endpoint when you need to register a new custom email domain under an existing AgentMail pod so that AI agents can send and receive email from addresses on that domain. Prefer this over manually managing DNS when you want AgentMail to generate the exact DNS verification records automatically. Choose this when setting up a fresh agent email infrastructure or expanding to a new domain.

## Known failure modes

- Invalid or malformed domain name — 400 Bad Request
- Pod ID not found or unauthorized — 404 or 403
- Domain already exists in this pod — 409 Conflict
- Missing required fields (domain or feedback_enabled) — 422 Unprocessable Entity
- Authentication token missing or invalid — 401 Unauthorized

## How this service works

Create Domain

## Output

Returns a Domain object containing the new domain_id, current verification status (e.g. NOT_STARTED), a list of DNS records (TXT, CNAME, MX) with their names, values, and validation statuses that must be added to the domain's DNS provider, whether feedback is enabled, and the creation/update timestamps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "CreateDomainRequest",
 "required": [
  "domain",
  "feedback_enabled"
 ],
 "properties": {
  "domain": {
   "type": "string",
   "title": "DomainName",
   "description": "The name of the domain. (e.g., \"example.com\")"
  },
  "feedback_enabled": {
   "type": "boolean",
   "title": "FeedbackEnabled",
   "description": "Bounce and complaint notifications are sent to your inboxes."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Domain",
 "required": [
  "domain_id",
  "status",
  "feedback_enabled",
  "records",
  "updated_at",
  "created_at"
 ],
 "properties": {
  "pod_id": {
   "type": "string",
   "title": "PodId",
   "description": "ID of pod."
  },
  "status": {
   "enum": [
    "NOT_STARTED",
    "PENDING",
    "INVALID",
    "FAILED",
    "VERIFYING",
    "VERIFIED"
   ],
   "type": "string",
   "title": "VerificationStatus"
  },
  "records": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "VerificationRecord",
    "required": [
     "type",
     "name",
     "value",
     "status"
    ],
    "properties": {
     "name": {
      "type": "string",
      "description": "The name or host of the record."
     },
     "type": {
      "enum": [
       "TXT",
       "CNAME",
       "MX"
      ],
      "type": "string",
      "title": "RecordType"
     },
     "value": {
      "type": "string",
      "description": "The value of the record."
     },
     "status": {
      "enum": [
       "MISSING",
       "INVALID",
       "VALID"
      ],
      "type": "string",
      "title": "RecordStatus"
     },
     "priority": {
      "type": "integer",
      "description": "The priority of the MX record."
     }
    }
   },
   "description": "A list of DNS records required to verify the domain."
  },
  "client_id": {
   "type": "string",
   "title": "ClientId",
   "description": "Client ID of domain."
  },
  "domain_id": {
   "type": "string",
   "title": "DomainId",
   "description": "The name of the domain. (e.g., \" your-domain.com\")"
  },
  "created_at": {
   "type": "string",
   "format": "date-time",
   "description": "Time at which the domain was created."
  },
  "updated_at": {
   "type": "string",
   "format": "date-time",
   "description": "Time at which the domain was last updated."
  },
  "feedback_enabled": {
   "type": "boolean",
   "title": "FeedbackEnabled",
   "description": "Bounce and complaint notifications are sent to your inboxes."
  }
 }
}
```

## More

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