{"uid":"cap_bvOpiz0xUCp2I1SSh00wW","slug":"agentmail-domains-15d268fd","name":"AgentMail Create Domain","description":"Create Domain","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/domains?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Registers a custom email domain within an AgentMail pod, returning DNS verification records needed to activate it","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:45:50.483Z","isFirstParty":false,"canonicalSlug":"agentmail-domains-11e156ac"}