{"uid":"cap_CmQ6QOULt_htDNKzISxGL","slug":"agentmail-domains-11e156ac","name":"AgentMail Create Domain","description":"Create Domain","url":"https://mpp.api.agentmail.to/v0/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":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_MMnABjIDlO6sOP5zz5Dp7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Registers a new email domain with AgentMail and returns DNS records required for verification","exampleAgentPrompt":"Set up mycompany.com as an email domain in AgentMail with bounce and complaint feedback notifications enabled, so I can create agent inboxes under that domain.","exampleUseCases":null,"resultDescription":"Returns a Domain object containing a domain_id, verification status (e.g. NOT_STARTED, PENDING, VERIFIED), a list of required DNS records (TXT, CNAME, MX) with their names, values, and current validation status, plus timestamps for creation and last update. Also includes client_id and pod_id for internal tracking.","failureModes":["Domain already registered — returns conflict error","Invalid domain name format — validation error on 'domain' field","Missing required fields (domain or feedback_enabled) — 400 Bad Request","Unauthorized — missing or invalid Bearer token returns 401","Domain name contains unsupported characters or TLD — validation failure"],"whenToPreferThis":"Use this endpoint when you need to register a custom domain within AgentMail so that AI agents can send and receive emails using addresses on that domain. This is the first step before creating inboxes under a custom domain. It is the right choice when the user owns the domain and is prepared to add DNS records for verification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-06-19T22:50:18.128Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:31:00.900Z","isFirstParty":false,"canonicalSlug":"agentmail-domains-11e156ac"}