{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Moonemail","colors":{"primary":"#24624c","light":"#4d9977","dark":"#24624c"},"api":{"playground":{"display":"simple","proxy":false},"examples":{"languages":["bash","javascript","python"]}},"appearance":{"default":"system"},"background":{"color":{"light":"#fbfcfb","dark":"#111b16"}},"navbar":{"links":[{"href":"mailto:support@moonemail.co","label":"Support"}],"primary":{"type":"button","label":"Open dashboard","href":"https://app.moonemail.co"}},"footer":{"links":[{"header":"Moonemail","items":[{"label":"Website","href":"https://moonemail.co"},{"label":"Privacy","href":"https://moonemail.co/privacy"},{"label":"Terms","href":"https://moonemail.co/terms"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"halyard-labs","hasAudioNarration":false,"actualSubdomain":"halyard-labs","customDomains":["docs.moonemail.co"],"gitSource":{"type":"github","owner":"halyard-labs","repo":"moonemail-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6ae292e818f709e275d32a43"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae2b148cec917d75a0bd68c","collectionId":"99c7723c-e053-4392-ad34-5640e30515e1","liveDeploymentHistoryId":"6ae2b148cec917d75a0bd68c","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2b148cec917d75a0bd68c","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API reference","count":36},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Domains","count":7},{"language":"default","tag":"Emails","count":7},{"language":"default","tag":"Build your integration","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Receiving","count":5},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"API keys","count":4},{"language":"default","tag":"Inboxes","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/domains/create-domain","slug":"/api-reference/domains/create-domain","pageMetadata":{"title":"Create domain","description":"Add a sending domain and return required DNS records. Does not publish DNS at your provider.\n\nRequired permission: `domains:write`.","deprecated":null,"version":null,"openapi":"/openapi.json post /domains","href":"/api-reference/domains/create-domain","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Add a sending domain and return required DNS records. Does not publish DNS at your provider.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Required permission: \", _jsx(_components.code, {\n children: \"domains:write\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create domain","description":"Add a sending domain and return required DNS records. Does not publish DNS at your provider.\n\nRequired permission: `domains:write`.","deprecated":null,"version":null,"openapi":"/openapi.json post /domains","href":"/api-reference/domains/create-domain","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"create_domain","summary":"Create domain","description":"Add a sending domain and return required DNS records. Does not publish DNS at your provider.\n\nRequired permission: `domains:write`.","tags":["Domains"],"security":["e8643755-5cf4-4baf-98f2-c9f14d87c5b6"],"x-required-scope":"domains:write","x-go-handler":"createDomain","x-mcp":{"enabled":true,"destructive":false,"idempotent":false},"requestBody":"42824819-e2ec-4b92-aa5b-3a3d582da7a6","responses":{"201":"d954623f-73d8-4301-91d6-01d70d88d7aa","default":"2f04a03d-3cd6-4bf0-ac55-228928883d9d"},"method":"post","type":"path","servers":["fe7e69c0-2c5d-423f-b223-6c01bf3642be"],"path":"/domains","baseUrlOptions":["https://api.moonemail.co"],"title":"Create domain","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":3,"maxLength":253,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"region":{"type":"string","const":"ap-southeast-2","uniqueKey":"region","typeLabel":"string"},"custom_return_path":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$","uniqueKey":"custom_return_path","typeLabel":"string"},"open_tracking":{"type":"boolean","uniqueKey":"open_tracking","typeLabel":"boolean"},"click_tracking":{"type":"boolean","uniqueKey":"click_tracking","typeLabel":"boolean"},"tracking_subdomain":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$","uniqueKey":"tracking_subdomain","typeLabel":"string"},"tls":{"type":"string","enum":["opportunistic","enforced"],"uniqueKey":"tls","typeLabel":"enum\u003cstring>"}},"required":["name"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","region":"ap-southeast-2","custom_return_path":"\u003cstring>","open_tracking":true,"click_tracking":true,"tracking_subdomain":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d954623f-73d8-4301-91d6-01d70d88d7aa":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"status":{"type":"string","enum":["not_started","pending","verified","failed","temporary_failure"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","isRequired":true,"uniqueKey":"created_at","typeLabel":"string"},"region":{"type":"string","isRequired":true,"uniqueKey":"region","typeLabel":"string"},"object":{"type":"string","const":"domain","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"open_tracking":{"type":"boolean","isRequired":true,"uniqueKey":"open_tracking","typeLabel":"boolean"},"click_tracking":{"type":"boolean","isRequired":true,"uniqueKey":"click_tracking","typeLabel":"boolean"},"tracking_subdomain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"tracking_subdomain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"tracking_subdomain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"tracking_subdomain","typeLabel":"string | null"},"custom_return_path":{"type":"string","isRequired":true,"uniqueKey":"custom_return_path","typeLabel":"string"},"tls":{"type":"string","enum":["opportunistic","enforced"],"isRequired":true,"uniqueKey":"tls","typeLabel":"enum\u003cstring>"},"capabilities":{"type":"object","properties":{"sending":{"type":"string","enum":["enabled","disabled"],"isRequired":true,"uniqueKey":"capabilities.sending","typeLabel":"enum\u003cstring>"},"receiving":{"type":"string","enum":["enabled","disabled"],"isRequired":true,"uniqueKey":"capabilities.receiving","typeLabel":"enum\u003cstring>"}},"required":["sending","receiving"],"additionalProperties":true,"isRequired":true,"uniqueKey":"capabilities","typeLabel":"object"},"records":{"type":"array","items":{"type":"object","properties":{"record":{"type":"string","enum":["DKIM","SPF","DMARC","Tracking"],"isRequired":true,"uniqueKey":"records.items.[INDEX].record","typeLabel":"enum\u003cstring>"},"name":{"type":"string","isRequired":true,"uniqueKey":"records.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["TXT","MX","CNAME"],"isRequired":true,"uniqueKey":"records.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"ttl":{"type":"string","const":"Auto","isRequired":true,"uniqueKey":"records.items.[INDEX].ttl","typeLabel":"string"},"status":{"type":"string","enum":["not_started","pending","verified","failed","temporary_failure"],"isRequired":true,"uniqueKey":"records.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"value":{"type":"string","isRequired":true,"uniqueKey":"records.items.[INDEX].value","typeLabel":"string"},"priority":{"type":"integer","uniqueKey":"records.items.[INDEX].priority","typeLabel":"integer"}},"required":["record","name","type","ttl","status","value"],"additionalProperties":true,"uniqueKey":"records.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"records","typeLabel":"object[]"}},"required":["id","name","status","created_at","region","object","open_tracking","click_tracking","tracking_subdomain","custom_return_path","tls","capabilities","records"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","name":"\u003cstring>","status":"not_started","created_at":"\u003cstring>","region":"\u003cstring>","object":"domain","open_tracking":true,"click_tracking":true,"tracking_subdomain":"\u003cstring>","custom_return_path":"\u003cstring>","tls":"opportunistic","capabilities":{"sending":"enabled","receiving":"enabled"},"records":[{"record":"DKIM","name":"\u003cstring>","type":"TXT","ttl":"Auto","status":"not_started","value":"\u003cstring>","priority":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"2f04a03d-3cd6-4bf0-ac55-228928883d9d":{"description":"API error","content":{"application/json":{"schema":{"type":"object","required":["statusCode","name","message"],"properties":{"statusCode":{"type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"name":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e8643755-5cf4-4baf-98f2-c9f14d87c5b6":{"bearerKey":{"type":"http","scheme":"bearer","description":"Moonemail API key; x-required-scope applies.","scopes":[],"schemeName":"bearerKey"}}},"servers":{"fe7e69c0-2c5d-423f-b223-6c01bf3642be":{"url":"https://api.moonemail.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Moonemail API key; x-required-scope applies.","scopes":[],"schemeName":"bearerKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Moonemail API key; x-required-scope applies.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerKey","name":"Authorization"}],"title":"bearerKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"halyard-labs","siteName":"Moonemail","title":"Create domain - Moonemail","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T00:40:27.763Z","originalFileLocation":"api-reference/domains/create-domain.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add a sending domain and return required DNS records. Does not publish DNS at your provider. Required permission: domains:write.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Moonemail\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/halyard-labs/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/halyard-labs/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/halyard-labs/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/halyard-labs/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create domain - Moonemail\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a sending domain and return required DNS records. Does not publish DNS at your provider. Required permission: domains:write.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Moonemail\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.moonemail.co/api-reference/domains/create-domain\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://halyard-labs.mintlify.app/_mintlify/api/og/v2?division=Domains\u0026amp;title=Create+domain\u0026amp;description=Add+a+sending+domain+and+return+required+DNS+records.+Does+not+publish+DNS+at+your+provider.%0A%0ARequired+permission%3A+%60domains%3Awrite%60.\u0026amp;theme=367ef022ab5942b69bc67513\u0026amp;signature=e38e102398de3687cedc470bfd1a2932bf6bae6f1712c87ee0be1317adbce051\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create domain - Moonemail\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a sending domain and return required DNS records. Does not publish DNS at your provider. Required permission: domains:write.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://halyard-labs.mintlify.app/_mintlify/api/og/v2?division=Domains\u0026amp;title=Create+domain\u0026amp;description=Add+a+sending+domain+and+return+required+DNS+records.+Does+not+publish+DNS+at+your+provider.%0A%0ARequired+permission%3A+%60domains%3Awrite%60.\u0026amp;theme=367ef022ab5942b69bc67513\u0026amp;signature=e38e102398de3687cedc470bfd1a2932bf6bae6f1712c87ee0be1317adbce051\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/halyard-labs/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Moonemail\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#24624c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.moonemail.co/api-reference/domains/create-domain\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/domains/create-domain.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.moonemail.co/#organization\",\"name\":\"Moonemail\",\"url\":\"https://docs.moonemail.co\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.moonemail.co#website\",\"name\":\"Moonemail\",\"url\":\"https://docs.moonemail.co\",\"publisher\":{\"@id\":\"https://docs.moonemail.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.moonemail.co/api-reference/domains/create-domain#webpage\",\"url\":\"https://docs.moonemail.co/api-reference/domains/create-domain\",\"name\":\"Create domain\",\"description\":\"Add a sending domain and return required DNS records. Does not publish DNS at your provider. Required permission: domains:write.\",\"dateModified\":\"2026-10-29T00:40:27.763Z\",\"isPartOf\":{\"@id\":\"https://docs.moonemail.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.moonemail.co/api-reference/domains/create-domain#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.moonemail.co/api-reference/domains/create-domain#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Moonemail\",\"item\":\"https://docs.moonemail.co\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create domain\",\"item\":\"https://docs.moonemail.co/api-reference/domains/create-domain\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.moonemail.co/api-reference/domains/create-domain#apireference\",\"headline\":\"Create domain\",\"name\":\"Create domain\",\"description\":\"Add a sending domain and return required DNS records. Does not publish DNS at your provider. Required permission: domains:write.\",\"url\":\"https://docs.moonemail.co/api-reference/domains/create-domain\",\"mainEntityOfPage\":{\"@id\":\"https://docs.moonemail.co/api-reference/domains/create-domain#webpage\"},\"dateModified\":\"2026-10-29T00:40:27.763Z\",\"publisher\":{\"@id\":\"https://docs.moonemail.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.moonemail.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Moonemail\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Moonemail","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Emails","pages":[{"title":"Send email","deprecated":null,"version":null,"openapi":"/openapi.json post /emails","href":"/api-reference/emails/send-email"},{"title":"Send batch","deprecated":null,"version":null,"openapi":"/openapi.json post /emails/batch","href":"/api-reference/emails/send-batch"},{"title":"List emails","deprecated":null,"version":null,"openapi":"/openapi.json get /emails","href":"/api-reference/emails/list-emails"},{"title":"Get email","deprecated":null,"version":null,"openapi":"/openapi.json get /emails/{id}","href":"/api-reference/emails/get-email"},{"title":"Update email","deprecated":null,"version":null,"openapi":"/openapi.json patch /emails/{id}","href":"/api-reference/emails/update-email"},{"title":"Cancel email","deprecated":null,"version":null,"openapi":"/openapi.json post /emails/{id}/cancel","href":"/api-reference/emails/cancel-email"},{"title":"List email events","description":"Read an email’s delivery events.\n\nRequired permission: `emails:read`.","deprecated":null,"version":null,"openapi":"/openapi.json get /emails/{id}/events","href":"/api-reference/emails/list-email-events"}]},{"group":"Domains","pages":[{"title":"Create domain","deprecated":null,"version":null,"openapi":"/openapi.json post /domains","href":"/api-reference/domains/create-domain"},{"title":"List domains","description":"List team sending domains.\n\nRequired permission: `domains:read`.","deprecated":null,"version":null,"openapi":"/openapi.json get /domains","href":"/api-reference/domains/list-domains"},{"title":"Get domain","deprecated":null,"version":null,"openapi":"/openapi.json get /domains/{id}","href":"/api-reference/domains/get-domain"},{"title":"Get domain health","deprecated":null,"version":null,"openapi":"/openapi.json get /domains/{id}/health","href":"/api-reference/domains/get-domain-health"},{"title":"Update domain","deprecated":null,"version":null,"openapi":"/openapi.json patch /domains/{id}","href":"/api-reference/domains/update-domain"},{"title":"Verify domain","deprecated":null,"version":null,"openapi":"/openapi.json post /domains/{id}/verify","href":"/api-reference/domains/verify-domain"},{"title":"Delete domain","deprecated":null,"version":null,"openapi":"/openapi.json delete /domains/{id}","href":"/api-reference/domains/delete-domain"}]},{"group":"Inboxes","pages":[{"title":"Create inbox","deprecated":null,"version":null,"openapi":"/openapi.json post /inboxes","href":"/api-reference/inboxes/create-inbox"},{"title":"List inboxes","deprecated":null,"version":null,"openapi":"/openapi.json get /inboxes","href":"/api-reference/inboxes/list-inboxes"},{"title":"Get inbox","deprecated":null,"version":null,"openapi":"/openapi.json get /inboxes/{id}","href":"/api-reference/inboxes/get-inbox"},{"title":"Update inbox","deprecated":null,"version":null,"openapi":"/openapi.json patch /inboxes/{id}","href":"/api-reference/inboxes/update-inbox"}]},{"group":"Receiving","pages":[{"title":"List received emails","deprecated":null,"version":null,"openapi":"/openapi.json get /emails/receiving","href":"/api-reference/receiving/list-received-emails"},{"title":"Get received email","deprecated":null,"version":null,"openapi":"/openapi.json get /emails/receiving/{id}","href":"/api-reference/receiving/get-received-email"},{"title":"List received attachments","deprecated":null,"version":null,"openapi":"/openapi.json get /emails/receiving/{id}/attachments","href":"/api-reference/receiving/list-received-attachments"},{"title":"Get received attachment","deprecated":null,"version":null,"openapi":"/openapi.json get /emails/receiving/{id}/attachments/{attachment_id}","href":"/api-reference/receiving/get-received-attachment"},{"title":"Get received raw","deprecated":null,"version":null,"openapi":"/openapi.json get /emails/receiving/{id}/raw","href":"/api-reference/receiving/get-received-raw"}]},{"group":"Webhooks","pages":[{"title":"Create webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Get webhook","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks/{id}","href":"/api-reference/webhooks/get-webhook"},{"title":"Update webhook","deprecated":null,"version":null,"openapi":"/openapi.json patch /webhooks/{id}","href":"/api-reference/webhooks/update-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /webhooks/{id}","href":"/api-reference/webhooks/delete-webhook"},{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks/{id}/deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"}]},{"group":"Suppressions","pages":[{"title":"List suppressions","deprecated":null,"version":null,"openapi":"/openapi.json get /suppressions","href":"/api-reference/suppressions/list-suppressions"},{"title":"Add suppression","deprecated":null,"version":null,"openapi":"/openapi.json post /suppressions","href":"/api-reference/suppressions/add-suppression"},{"title":"Remove suppression","deprecated":null,"version":null,"openapi":"/openapi.json delete /suppressions/{email}","href":"/api-reference/suppressions/remove-suppression"}]},{"group":"API keys","pages":[{"title":"Get permissions","deprecated":null,"version":null,"openapi":"/openapi.json get /permissions","href":"/api-reference/permissions/get-permissions"},{"title":"Create API key","deprecated":null,"version":null,"openapi":"/openapi.json post /api-keys","href":"/api-reference/api-keys/create-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Delete API key","deprecated":null,"version":null,"openapi":"/openapi.json delete /api-keys/{id}","href":"/api-reference/api-keys/delete-api-key"}]}]}]},"title":"Create domain - Moonemail","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}