{
"message": "Conflict",
"details": "You are attempting to subscribe to an event you have already subscribed to."
}
{
"message": "The 'Content-Type' header must be 'application/json' for this request."
}
{
"message": "Rate Limit Exceeded"
}
{
"message": "Internal Server Error",
"details": "Something went wrong."
}
{
"message": "The server received an invalid response from the upstream server."
}
{
"message": "Service Unavailable",
"details": "The API is offline for scheduled maintenance. See https://status.name.com for updates."
}
{
"message": "The upstream server is taking too long to respond."
}
Subscriptions
Subscribe to Notification
Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes.
Supported webhook event names:
account.credit.balance_change – account credit balance changes (increases or decreases).
account.domain.removal – domain removed from the subscribing account.
domain.lock.status_change – domain lock added or removed.
domain.transfer.status_change – domain transfer IN to name.com; status updates while name.com is the gaining registrar.
domain.transfer_out.status_change – domain transfer OUT from name.com; initiated, completed (domain removed), or canceled (no longer pending at the registry).
domain.transfer.internal_in - name.com domain transfers in to the subscribing account via internal transfer.
domain.transfer.internal_out - name.com domain transfers out of the subscribing account via internal transfer.
contact.verification.status_change - contact verification status changes (verified or unverified).
domain.registry.rejection – domain create failed after asynchronous registry processing (uncommon; most creates succeed at request time).
domain.registry.compliance_notice – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path.
domain.expiration – domain has expired and entered the post-expiry grace period. This is informational only.
Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.
Body
application/json
Request to subscribe to a specific webhook notification
If the webhook should be active. This allows a webhook to be deactivated in our system. It may be useful to deactivate a webhook if the server that receives the POST request is undergoing scheduled maintenance, for example.
*
The record for each notification you have subscribed to · object
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"name.com Core API","colors":{"primary":"#1EAA50","dark":"#6EDA78"},"logo":{"light":"https://namedotcom-cdn.name.tools/media/logo/name_logo.svg","dark":"https://namedotcom-cdn.name.tools/media/logo/name_logo-white.svg","href":"https://www.name.com"},"favicon":"https://mintcdn.com/namecom/1rmHLXcBmhL0Pefk/favicon.svg?fit=max\u0026auto=format\u0026n=1rmHLXcBmhL0Pefk\u0026q=85\u0026s=e6f65c5c71b5abe116a4673dca9c256a","api":{"playground":{}},"appearance":{"default":"dark"},"seo":{"metatags":{"google-site-verification":"f-XFmxTzeRzcOF9-ocrS8hNiAemBYY4jDUL5xJwuC9M"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"namecom","hasAudioNarration":false,"actualSubdomain":"namecom","customDomains":["docs.name.com"],"gitSource":{"type":"github","owner":"namedotcom","repo":"coreapi","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ace6015aae446d0f8f844d6","collectionId":"ac21103e-fe0b-4a86-b7ac-6bf690a461c9","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ace6015aae446d0f8f844d6"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ace6015aae446d0f8f844d6","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Core API Reference","count":84},{"language":"default","tag":"Domains","count":19},{"language":"default","tag":"Guides \u0026 Flows","count":18},{"language":"default","tag":"Webhook Notifications","count":16},{"language":"default","tag":"URL Forwardings","count":9},{"language":"default","tag":"Transfers","count":7},{"language":"default","tag":"Operations \u0026 Compliance","count":6},{"language":"default","tag":"DNS","count":5},{"language":"default","tag":"Email Forwardings","count":5},{"language":"default","tag":"External","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"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":"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":"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":"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":"full-page-search","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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v1/reference/webhook-notifications/subscribe-to-notification","slug":"/api/v1/reference/webhook-notifications/subscribe-to-notification","pageMetadata":{"title":"Subscribe to Notification","openapi":"post /core/v1/notifications","description":"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes.\nSupported webhook event names:\n- `account.credit.balance_change` – account credit balance changes (increases or decreases).\n- `account.domain.removal` – domain removed from the subscribing account.\n- `domain.lock.status_change` – domain lock added or removed.\n- `domain.transfer.status_change` – domain transfer IN to name.com; status updates while name.com is the gaining registrar.\n- `domain.transfer_out.status_change` – domain transfer OUT from name.com; `initiated`, `completed` (domain removed), or `canceled` (no longer pending at the registry).\n- `domain.transfer.internal_in` - name.com domain transfers in to the subscribing account via internal transfer.\n- `domain.transfer.internal_out` - name.com domain transfers out of the subscribing account via internal transfer.\n- `contact.verification.status_change` - contact verification status changes (verified or unverified).\n- `domain.registry.rejection` – domain **create** failed after asynchronous registry processing (uncommon; most creates succeed at request time).\n- `domain.registry.compliance_notice` – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path.\n- `domain.expiration` – domain has expired and entered the post-expiry grace period. This is informational only.","href":"/api/v1/reference/webhook-notifications/subscribe-to-notification"},"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 li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes.\\nSupported webhook event names:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"account.credit.balance_change\"\n }), \" – account credit balance changes (increases or decreases).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"account.domain.removal\"\n }), \" – domain removed from the subscribing account.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.lock.status_change\"\n }), \" – domain lock added or removed.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.transfer.status_change\"\n }), \" – domain transfer IN to name.com; status updates while name.com is the gaining registrar.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.transfer_out.status_change\"\n }), \" – domain transfer OUT from name.com; \", _jsx(_components.code, {\n children: \"initiated\"\n }), \", \", _jsx(_components.code, {\n children: \"completed\"\n }), \" (domain removed), or \", _jsx(_components.code, {\n children: \"canceled\"\n }), \" (no longer pending at the registry).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.transfer.internal_in\"\n }), \" - name.com domain transfers in to the subscribing account via internal transfer.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.transfer.internal_out\"\n }), \" - name.com domain transfers out of the subscribing account via internal transfer.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"contact.verification.status_change\"\n }), \" - contact verification status changes (verified or unverified).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.registry.rejection\"\n }), \" – domain \", _jsx(_components.strong, {\n children: \"create\"\n }), \" failed after asynchronous registry processing (uncommon; most creates succeed at request time).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.registry.compliance_notice\"\n }), \" – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"domain.expiration\"\n }), \" – domain has expired and entered the post-expiry grace period. This is informational only.\"]\n }), \"\\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":"Subscribe to Notification","openapi":"post /core/v1/notifications","description":"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes.\nSupported webhook event names:\n- `account.credit.balance_change` – account credit balance changes (increases or decreases).\n- `account.domain.removal` – domain removed from the subscribing account.\n- `domain.lock.status_change` – domain lock added or removed.\n- `domain.transfer.status_change` – domain transfer IN to name.com; status updates while name.com is the gaining registrar.\n- `domain.transfer_out.status_change` – domain transfer OUT from name.com; `initiated`, `completed` (domain removed), or `canceled` (no longer pending at the registry).\n- `domain.transfer.internal_in` - name.com domain transfers in to the subscribing account via internal transfer.\n- `domain.transfer.internal_out` - name.com domain transfers out of the subscribing account via internal transfer.\n- `contact.verification.status_change` - contact verification status changes (verified or unverified).\n- `domain.registry.rejection` – domain **create** failed after asynchronous registry processing (uncommon; most creates succeed at request time).\n- `domain.registry.compliance_notice` – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path.\n- `domain.expiration` – domain has expired and entered the post-expiry grace period. This is informational only.","href":"/api/v1/reference/webhook-notifications/subscribe-to-notification"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes.\nSupported webhook event names:\n- `account.credit.balance_change` – account credit balance changes (increases or decreases).\n- `account.domain.removal` – domain removed from the subscribing account.\n- `domain.lock.status_change` – domain lock added or removed.\n- `domain.transfer.status_change` – domain transfer IN to name.com; status updates while name.com is the gaining registrar.\n- `domain.transfer_out.status_change` – domain transfer OUT from name.com; `initiated`, `completed` (domain removed), or `canceled` (no longer pending at the registry).\n- `domain.transfer.internal_in` - name.com domain transfers in to the subscribing account via internal transfer.\n- `domain.transfer.internal_out` - name.com domain transfers out of the subscribing account via internal transfer.\n- `contact.verification.status_change` - contact verification status changes (verified or unverified).\n- `domain.registry.rejection` – domain **create** failed after asynchronous registry processing (uncommon; most creates succeed at request time).\n- `domain.registry.compliance_notice` – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path.\n- `domain.expiration` – domain has expired and entered the post-expiry grace period. This is informational only.","operationId":"SubscribeToNotification","requestBody":"743fcd14-e4ba-4e76-9af4-5aeb59733ad3","responses":{"201":"1800d722-5dad-4e16-9e17-2d6b576b1bb4","400":"0bcd4e78-854a-42d7-ac6e-3ffc471d4492","401":"e3b3b10c-6258-45ce-9135-148392dbcd65","403":"07dd7d43-f69e-4616-aa52-2c605c3ff127","405":"2f554944-da84-4d6d-99b7-f9b83e3275c5","409":"b97a3904-5c9b-4bf5-a2a8-b9ccaf62cc74","415":"369d466f-15a2-4620-99af-ce65aeb94b0f","429":"5192df1f-20bd-4360-b67d-0ab3927a41c9","500":"51519359-ce31-436b-86eb-8b5b35de3110","502":"56793743-d772-42e8-ade0-9fd6e555e798","503":"9a74e372-e4d3-4ad4-9448-6eb94539fa8b","504":"a396bea9-af58-4358-8048-cac98f0a9056"},"summary":"Subscribe to Notification","tags":["Webhook Notifications"],"method":"post","type":"path","servers":["a299706b-162f-4709-8731-1da4aafad643"],"security":["d8600753-25c5-4f15-8e86-e3efcdef3502"],"path":"/core/v1/notifications","baseUrlOptions":["https://api.dev.name.com"],"title":"Subscribe to Notification","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"description":"Request to subscribe to a specific webhook notification","properties":{"eventName":{"description":"The list of configured webhooks you can subscribe to","type":"string","enum":["account.credit.balance_change","account.domain.removal","domain.lock.status_change","domain.transfer.status_change","domain.transfer_out.status_change","contact.verification.status_change","domain.transfer.internal_in","domain.transfer.internal_out","domain.registry.rejection","domain.registry.compliance_notice","domain.expiration"],"isRequired":true,"uniqueKey":"eventName","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"The URL we will send the notification data to","example":"https://example.com","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"active":{"type":"boolean","description":"If the webhook should be active. This allows a webhook to be deactivated in our system. It may be useful to deactivate a webhook if the server that receives the POST request is undergoing scheduled maintenance, for example.","isRequired":true,"uniqueKey":"active","typeLabel":"boolean"}},"required":["eventName","url","active"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"url":"https://example.com","active":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1800d722-5dad-4e16-9e17-2d6b576b1bb4":{"content":{"application/json":{"schema":{"properties":{"subscription":{"properties":{"active":{"title":"Whether or not the subscription is active","type":"boolean","isRequired":true,"uniqueKey":"subscription.active","typeLabel":"boolean"},"createDate":{"title":"Date the subscription record was created (Date you subscribed)","type":"string","isRequired":true,"uniqueKey":"subscription.createDate","typeLabel":"string"},"eventName":{"title":"The name of the event you have subscribed to","type":"string","isRequired":true,"uniqueKey":"subscription.eventName","typeLabel":"string"},"id":{"format":"int32","title":"The ID of the event record. Used for updating and canceling","type":"integer","isRequired":true,"uniqueKey":"subscription.id","typeLabel":"integer\u003cint32>"},"updateDate":{"oneOf":[{"title":"Date the subscription record was updated (Date you made changes)","type":"string","isRequired":true,"uniqueKey":"subscription.updateDate.oneOf.0","typeLabel":"string"},{"title":"Date the subscription record was updated (Date you made changes)","type":"null","isRequired":true,"uniqueKey":"subscription.updateDate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"subscription.updateDate","typeLabel":"string | null"},"url":{"title":"The URL we will send a POST request to with the notification message","type":"string","isRequired":true,"uniqueKey":"subscription.url","typeLabel":"string"}},"required":["active","id","createDate","eventName","url","updateDate"],"title":"*\nThe record for each notification you have subscribed to","type":"object","uniqueKey":"subscription","typeLabel":"*\nThe record for each notification you have subscribed to · object"}},"title":"Response from subscribing to a notification","type":"object","uniqueKey":"","typeLabel":"Response from subscribing to a notification · object"},"examples":{"Example":{"title":"Example","value":{"subscription":{"active":true,"createDate":"\u003cstring>","eventName":"\u003cstring>","id":123,"updateDate":"\u003cstring>","url":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"A successful response.","exampleType":"generated"},"0bcd4e78-854a-42d7-ac6e-3ffc471d4492":{"description":"Bad request - Invalid input data.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Bad Request","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error","example":"'domainName' cannot be null","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error","example":"'domainName' cannot be null","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Bad Request","details":"'domainName' cannot be null"}}},"exampleType":"generated"}},"exampleType":"generated"},"e3b3b10c-6258-45ce-9135-148392dbcd65":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Unauthorized","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"07dd7d43-f69e-4616-aa52-2c605c3ff127":{"description":"Forbidden - you do not have permission to perform this action.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Permission denied","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error","example":"Failed authentication","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error","example":"Failed authentication","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Permission denied","details":"Failed authentication"}}},"exampleType":"generated"}},"exampleType":"generated"},"2f554944-da84-4d6d-99b7-f9b83e3275c5":{"description":"Method not allowed.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Method Not Allowed","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Method Not Allowed"}}},"exampleType":"generated"}},"exampleType":"generated"},"b97a3904-5c9b-4bf5-a2a8-b9ccaf62cc74":{"description":"The API will return this response if you are attempting to subscribe to a webhook you have already subscribed to.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Conflict","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"string","description":"Additional context or information about the pricing error","example":"You are attempting to subscribe to an event you have already subscribed to.","uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Conflict","details":"You are attempting to subscribe to an event you have already subscribed to."}}},"exampleType":"generated"}},"exampleType":"generated"},"369d466f-15a2-4620-99af-ce65aeb94b0f":{"description":"All POST, PUT, PATCH requests for this API must include the `Content-Type: application/json` header in the requests.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"The 'Content-Type' header must be 'application/json' for this request.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The 'Content-Type' header must be 'application/json' for this request."}}},"exampleType":"generated"}},"exampleType":"generated"},"5192df1f-20bd-4360-b67d-0ab3927a41c9":{"description":"Rate limit has been exceeded.","content":{"application/json":{"schema":{"type":"object","required":["message","details"],"properties":{"message":{"type":"string","description":"### Too Many Requests\nYou have exceeded the rate limit.\n\n**Headers returned:**\n* 'X-RateLimit-Reset': An integer (UTC epoch) indicating when you can retry.","example":"Rate Limit Exceeded","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Rate Limit Exceeded"}}},"exampleType":"generated"}},"headers":{"x-ratelimit-reset":{"description":"Unix timestamp for the time at which the current rate limit will reset.","schema":{"type":"number","example":1747668270}}},"exampleType":"generated"},"51519359-ce31-436b-86eb-8b5b35de3110":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","example":"Internal Server Error","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error.","example":"Something went wrong.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error.","example":"Something went wrong.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal Server Error","details":"Something went wrong."}}},"exampleType":"generated"}},"exampleType":"generated"},"56793743-d772-42e8-ade0-9fd6e555e798":{"description":"Bad Gateway","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","example":"The server received an invalid response from the upstream server.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The server received an invalid response from the upstream server."}}},"exampleType":"generated"}},"exampleType":"generated"},"9a74e372-e4d3-4ad4-9448-6eb94539fa8b":{"description":"Service Unavailable — returned during scheduled maintenance when the API is offline. See https://status.name.com for updates.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","example":"Service Unavailable","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error.","example":"The API is offline for scheduled maintenance. See https://status.name.com for updates.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error.","example":"The API is offline for scheduled maintenance. See https://status.name.com for updates.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Service Unavailable","details":"The API is offline for scheduled maintenance. See https://status.name.com for updates."}}},"exampleType":"generated"}},"exampleType":"generated"},"a396bea9-af58-4358-8048-cac98f0a9056":{"description":"Gateway Timeout","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","example":"The upstream server is taking too long to respond.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The upstream server is taking too long to respond."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d8600753-25c5-4f15-8e86-e3efcdef3502":{"BasicAuth":{"scheme":"basic","type":"http","description":"Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic \u003cbase64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append \"-test\" to your username and use your sandbox token on api.dev.name.com.","scopes":[],"schemeName":"BasicAuth"}}},"servers":{"a299706b-162f-4709-8731-1da4aafad643":{"description":"Testing","url":"https://api.dev.name.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"basic","type":"http","description":"Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic \u003cbase64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append \"-test\" to your username and use your sandbox token on api.dev.name.com.","scopes":[],"schemeName":"BasicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic \u003cbase64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append \"-test\" to your username and use your sandbox token on api.dev.name.com.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"BasicAuth","name":"Authorization"}],"title":"BasicAuth"}]},"originalFileLocation":"api/v1/namecom.api.yaml"},"subdomain":"namecom","siteName":"name.com Core API","title":"Subscribe to Notification - name.com Core API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T23:24:00.466Z","originalFileLocation":"api/v1/reference/webhook-notifications/subscribe-to-notification.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=\"dark\"}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=\"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. Supported webhook event names: - account.credit.balance_change – account credit balance changes (increases or decreases). - account.domain.removal – domain removed from the subscribing account. - domain.lock.status_change – domain lock added or removed. - domain.transfer.status_change – domain transfer IN to name.com; status updates while name.com is the gaining registrar. - domain.transfer_out.status_change – domain transfer OUT from name.com; initiated, completed (domain removed), or canceled (no longer pending at the registry). - domain.transfer.internal_in - name.com domain transfers in to the subscribing account via internal transfer. - domain.transfer.internal_out - name.com domain transfers out of the subscribing account via internal transfer. - contact.verification.status_change - contact verification status changes (verified or unverified). - domain.registry.rejection – domain create failed after asynchronous registry processing (uncommon; most creates succeed at request time). - domain.registry.compliance_notice – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path. - domain.expiration – domain has expired and entered the post-expiry grace period. This is informational only.\">\u003cmeta data-mint-head name=\"application-name\" content=\"name.com Core API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Subscribe to Notification - name.com Core API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. Supported webhook event names: - account.credit.balance_change – account credit balance changes (increases or decreases). - account.domain.removal – domain removed from the subscribing account. - domain.lock.status_change – domain lock added or removed. - domain.transfer.status_change – domain transfer IN to name.com; status updates while name.com is the gaining registrar. - domain.transfer_out.status_change – domain transfer OUT from name.com; initiated, completed (domain removed), or canceled (no longer pending at the registry). - domain.transfer.internal_in - name.com domain transfers in to the subscribing account via internal transfer. - domain.transfer.internal_out - name.com domain transfers out of the subscribing account via internal transfer. - contact.verification.status_change - contact verification status changes (verified or unverified). - domain.registry.rejection – domain create failed after asynchronous registry processing (uncommon; most creates succeed at request time). - domain.registry.compliance_notice – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path. - domain.expiration – domain has expired and entered the post-expiry grace period. This is informational only.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"name.com Core API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://namecom.mintlify.app/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Subscribe+to+Notification\u0026amp;description=Creates+a+webhook+subscription+to+receive+real-time+notifications+about+specific+domain+or+account+events+%28e.g.+transfer+completions%2C+renewals%29.+Pass+the+callba\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=552ff7ea7d7db3ffd3862fc853fdc46091958670e2fd051ecd70228b918f7d24\">\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=\"Subscribe to Notification - name.com Core API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. Supported webhook event names: - account.credit.balance_change – account credit balance changes (increases or decreases). - account.domain.removal – domain removed from the subscribing account. - domain.lock.status_change – domain lock added or removed. - domain.transfer.status_change – domain transfer IN to name.com; status updates while name.com is the gaining registrar. - domain.transfer_out.status_change – domain transfer OUT from name.com; initiated, completed (domain removed), or canceled (no longer pending at the registry). - domain.transfer.internal_in - name.com domain transfers in to the subscribing account via internal transfer. - domain.transfer.internal_out - name.com domain transfers out of the subscribing account via internal transfer. - contact.verification.status_change - contact verification status changes (verified or unverified). - domain.registry.rejection – domain create failed after asynchronous registry processing (uncommon; most creates succeed at request time). - domain.registry.compliance_notice – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path. - domain.expiration – domain has expired and entered the post-expiry grace period. This is informational only.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://namecom.mintlify.app/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Subscribe+to+Notification\u0026amp;description=Creates+a+webhook+subscription+to+receive+real-time+notifications+about+specific+domain+or+account+events+%28e.g.+transfer+completions%2C+renewals%29.+Pass+the+callba\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=552ff7ea7d7db3ffd3862fc853fdc46091958670e2fd051ecd70228b918f7d24\">\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=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"name.com Core API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1EAA50\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"f-XFmxTzeRzcOF9-ocrS8hNiAemBYY4jDUL5xJwuC9M\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/v1/reference/webhook-notifications/subscribe-to-notification.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.name.com/#organization\",\"name\":\"name.com Core API\",\"url\":\"https://docs.name.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://namedotcom-cdn.name.tools/media/logo/name_logo.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.name.com#website\",\"name\":\"name.com Core API\",\"url\":\"https://docs.name.com\",\"publisher\":{\"@id\":\"https://docs.name.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification#webpage\",\"url\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification\",\"name\":\"Subscribe to Notification\",\"description\":\"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. Supported webhook event names: - account.credit.balance_change – account credit balance changes (increases or decreases). - account.domain.removal – domain removed from the subscribing account. - domain.lock.status_change – domain lock added or removed. - domain.transfer.status_change – domain transfer IN to name.com; status updates while name.com is the gaining registrar. - domain.transfer_out.status_change – domain transfer OUT from name.com; initiated, completed (domain removed), or canceled (no longer pending at the registry). - domain.transfer.internal_in - name.com domain transfers in to the subscribing account via internal transfer. - domain.transfer.internal_out - name.com domain transfers out of the subscribing account via internal transfer. - contact.verification.status_change - contact verification status changes (verified or unverified). - domain.registry.rejection – domain create failed after asynchronous registry processing (uncommon; most creates succeed at request time). - domain.registry.compliance_notice – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path. - domain.expiration – domain has expired and entered the post-expiry grace period. This is informational only.\",\"dateModified\":\"2026-09-16T23:24:00.466Z\",\"isPartOf\":{\"@id\":\"https://docs.name.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core API Reference\",\"item\":\"https://docs.name.com/api/v1/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhook Notifications\",\"item\":\"https://docs.name.com/api/v1/reference/webhook-notifications/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Subscriptions\",\"item\":\"https://docs.name.com/api/v1/reference/webhook-notifications/get-subscribed-notifications\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Subscribe to Notification\",\"item\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification#apireference\",\"headline\":\"Subscribe to Notification\",\"name\":\"Subscribe to Notification\",\"description\":\"Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. Supported webhook event names: - account.credit.balance_change – account credit balance changes (increases or decreases). - account.domain.removal – domain removed from the subscribing account. - domain.lock.status_change – domain lock added or removed. - domain.transfer.status_change – domain transfer IN to name.com; status updates while name.com is the gaining registrar. - domain.transfer_out.status_change – domain transfer OUT from name.com; initiated, completed (domain removed), or canceled (no longer pending at the registry). - domain.transfer.internal_in - name.com domain transfers in to the subscribing account via internal transfer. - domain.transfer.internal_out - name.com domain transfers out of the subscribing account via internal transfer. - contact.verification.status_change - contact verification status changes (verified or unverified). - domain.registry.rejection – domain create failed after asynchronous registry processing (uncommon; most creates succeed at request time). - domain.registry.compliance_notice – a registry requires policy remediation for a domain. Default is a registrant email (whitelabeled when configured); subscribe to send it yourself. If you have signed an addendum to assume all email responsibility, name.com does not send this email and the webhook is the only delivery path. - domain.expiration – domain has expired and entered the post-expiry grace period. This is informational only.\",\"url\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification\",\"mainEntityOfPage\":{\"@id\":\"https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification#webpage\"},\"dateModified\":\"2026-09-16T23:24:00.466Z\",\"publisher\":{\"@id\":\"https://docs.name.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.name.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"name.com Core API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"name.com Core API","nav":{"global":null,"groups":[{"group":"API Home","pages":[{"title":"name.com Core API Documentation","href":"/index"}]},{"group":"Guides \u0026 Flows","pages":[{"title":"v4 to CORE API Migration","href":"/guides/migration-guide"},{"group":"Setup","pages":[{"title":"Authentication","href":"/guides/authentication"},{"title":"Getting Started","href":"/guides/getting-started"},{"title":"Testing Environment","href":"/guides/testing-environment"}]},{"group":"Build \u0026 Launch","pages":[{"title":"Reseller Quickstart","href":"/guides/quickstart"},{"title":"Domain Purchase Pricing","href":"/guides/domain-pricing"},{"title":"Quickstart TLD List","href":"/guides/quickstart-recommended-tlds"}]},{"group":"Operations \u0026 Compliance","pages":[{"title":"Contact Verification Compliance","href":"/guides/contact-verification"},{"title":"Domain Renewals \u0026 Expiration","href":"/guides/domain-renewals-expiration"},{"title":"Funding Your name.com Account","href":"/guides/funding-your-namecom-account"},{"title":"HMAC Signature Verification","href":"/guides/hmac-examples"},{"title":"Registrant Communications","href":"/guides/registrant-communications"},{"title":"Understanding Domain Locks","href":"/guides/domain-locks"}]},{"group":"Flows","pages":[{"title":"Claims Flow","href":"/guides/claims-flow"},{"title":"External Transfers Flow","href":"/guides/external-transfers-flow"},{"title":"Refunds Flow","href":"/guides/refunds-flow"}]},{"group":"MCP Integrations","pages":[{"title":"API Docs MCP","href":"/integrations/mcp/api-docs-mcp"},{"title":"name.com MCP","href":"/integrations/mcp/namecom-mcp"}]}]},{"group":"Official SDKs","tag":"NEW","pages":[{"title":"SDK Quickstart","href":"/sdks/index"}]},{"group":"Core API Reference","pages":[{"title":"API Overview","href":"/api/v1/overview"},{"group":"Hello","pages":[{"openapi":"get /core/v1/hello","title":"Hello","href":"/api/v1/reference/hello/hello"}]},{"group":"Account Info","pages":[{"openapi":"get /core/v1/accountinfo/balance","title":"Check Account Balance","href":"/api/v1/reference/account-info/check-account-balance"}]},{"group":"Contact Verification","pages":[{"openapi":"get /core/v1/contacts/unverified","title":"List Unverified Contacts","href":"/api/v1/reference/contact-verification/list-unverified-contacts"},{"openapi":"post /core/v1/contacts/verify/{verificationId}","title":"Verify Contact","href":"/api/v1/reference/contact-verification/verify-contact"},{"openapi":"post /core/v1/contacts/verify/{verificationId}:resend","title":"Resend Contact Verification Email","href":"/api/v1/reference/contact-verification/resend-verification-email"}]},{"group":"Domains","pages":[{"openapi":"get /core/v1/domains","title":"List Domains","href":"/api/v1/reference/domains/list-domains"},{"openapi":"post /core/v1/domains","title":"Create Domain","href":"/api/v1/reference/domains/create-domain"},{"openapi":"get /core/v1/domains/{domainName}","title":"Get Domain","href":"/api/v1/reference/domains/get-domain"},{"openapi":"patch /core/v1/domains/{domainName}","title":"Update a domain","href":"/api/v1/reference/domains/update-a-domain"},{"openapi":"get /core/v1/domains/{domainName}:getAuthCode","title":"Get Auth Code For Domain","href":"/api/v1/reference/domains/get-auth-code-for-domain"},{"openapi":"get /core/v1/domains/{domainName}:getPricing","title":"Get Pricing For Domain","href":"/api/v1/reference/domains/get-pricing-for-domain"},{"openapi":"post /core/v1/domains/{domainName}:purchasePrivacy","title":"Purchase Privacy","href":"/api/v1/reference/domains/purchase-privacy"},{"openapi":"post /core/v1/domains/{domainName}:renew","title":"Renew Domain","href":"/api/v1/reference/domains/renew-domain"},{"openapi":"post /core/v1/domains/{domainName}:setContacts","title":"Set Contacts","href":"/api/v1/reference/domains/set-contacts"},{"openapi":"post /core/v1/domains/{domainName}:setNameservers","title":"Set Nameservers","href":"/api/v1/reference/domains/set-nameservers"},{"openapi":"post /core/v1/domains:checkAvailability","title":"Check Availability","href":"/api/v1/reference/domains/check-availability"},{"openapi":"post /core/v1/domains:search","title":"Search","href":"/api/v1/reference/domains/search"},{"openapi":"post /core/v1/zonecheck","title":"Zone Check","href":"/api/v1/reference/domains/zone-check"},{"openapi":"post /core/v1/domains/{domainName}:disableAutorenew","deprecated":true,"title":"Disable Autorenew","href":"/api/v1/reference/domains/disable-autorenew"},{"openapi":"post /core/v1/domains/{domainName}:disableWhoisPrivacy","deprecated":true,"title":"Disable Whois Privacy","href":"/api/v1/reference/domains/disable-whois-privacy"},{"openapi":"post /core/v1/domains/{domainName}:enableAutorenew","deprecated":true,"title":"Enable Autorenew","href":"/api/v1/reference/domains/enable-autorenew"},{"openapi":"post /core/v1/domains/{domainName}:enableWhoisPrivacy","deprecated":true,"title":"Enable Whois Privacy","href":"/api/v1/reference/domains/enable-whois-privacy"},{"openapi":"post /core/v1/domains/{domainName}:lock","deprecated":true,"title":"Lock Domain","href":"/api/v1/reference/domains/lock-domain"},{"openapi":"post /core/v1/domains/{domainName}:unlock","deprecated":true,"title":"Unlock Domain","href":"/api/v1/reference/domains/unlock-domain"}]},{"group":"Domain Info","pages":[{"openapi":"get /core/v1/domaininfo/requirementsV2/{tld}","title":"Get TLD Requirements as JSON Schema","href":"/api/v1/reference/domain-info/get-specific-tld-requirements-v2"},{"openapi":"get /core/v1/domaininfo/requirements/{tld}","title":"Get Specific TLD Requirements","href":"/api/v1/reference/domain-info/get-specific-tld-requirements"},{"openapi":"post /core/v1/domaininfo/claims/{domain}","title":"Check Domain Claims","href":"/api/v1/reference/domain-info/check-domain-claims"}]},{"group":"DNS","pages":[{"openapi":"get /core/v1/domains/{domainName}/records","title":"List Records","href":"/api/v1/reference/dns/list-records"},{"openapi":"post /core/v1/domains/{domainName}/records","title":"Create Record","href":"/api/v1/reference/dns/create-record"},{"openapi":"get /core/v1/domains/{domainName}/records/{id}","title":"Get Record","href":"/api/v1/reference/dns/get-record"},{"openapi":"put /core/v1/domains/{domainName}/records/{id}","title":"Update Record","href":"/api/v1/reference/dns/update-record"},{"openapi":"delete /core/v1/domains/{domainName}/records/{id}","title":"Delete Record","href":"/api/v1/reference/dns/delete-record"}]},{"group":"DNSSECs","pages":[{"openapi":"get /core/v1/domains/{domainName}/dnssec","title":"List DNSSECs","href":"/api/v1/reference/dnssecs/list-dnssecs"},{"openapi":"post /core/v1/domains/{domainName}/dnssec","title":"Create DNSSEC","href":"/api/v1/reference/dnssecs/create-dnssec"},{"openapi":"get /core/v1/domains/{domainName}/dnssec/{digest}","title":"Get DNSSEC","href":"/api/v1/reference/dnssecs/get-dnssec"},{"openapi":"delete /core/v1/domains/{domainName}/dnssec/{digest}","title":"Delete DNSSEC","href":"/api/v1/reference/dnssecs/delete-dnssec"}]},{"group":"Email Forwardings","pages":[{"openapi":"get /core/v1/domains/{domainName}/email/forwarding","title":"List Email Forwardings","href":"/api/v1/reference/email-forwardings/list-email-forwardings"},{"openapi":"post /core/v1/domains/{domainName}/email/forwarding","title":"Create Email Forwarding","href":"/api/v1/reference/email-forwardings/create-email-forwarding"},{"openapi":"get /core/v1/domains/{domainName}/email/forwarding/{emailBox}","title":"Get Email Forwarding","href":"/api/v1/reference/email-forwardings/get-email-forwarding"},{"openapi":"put /core/v1/domains/{domainName}/email/forwarding/{emailBox}","title":"Update Email Forwarding","href":"/api/v1/reference/email-forwardings/update-email-forwarding"},{"openapi":"delete /core/v1/domains/{domainName}/email/forwarding/{emailBox}","title":"Delete Email Forwarding","href":"/api/v1/reference/email-forwardings/delete-email-forwarding"}]},{"group":"Orders","pages":[{"openapi":"get /core/v1/orders","title":"List Orders","href":"/api/v1/reference/orders/list-orders"},{"openapi":"get /core/v1/orders/{orderId}","title":"Get Order","href":"/api/v1/reference/orders/get-order"}]},{"group":"Refunds","pages":[{"openapi":"post /core/v1/refund","title":"Process Refund","href":"/api/v1/reference/refunds/process-refund"}]},{"group":"Premium Domains","pages":[{"openapi":"get /core/v1/premiumdomainslist","title":"Download Premium Domain Lists","href":"/api/v1/reference/premium-domains/download-premium-domain-lists"}]},{"group":"TLD Pricing","pages":[{"openapi":"get /core/v1/tldpricing","title":"TLD Price List","href":"/api/v1/reference/tld-pricing/tld-price-list"}]},{"group":"Transfers","pages":[{"title":"Check Transfer Eligibility","openapi":"get /core/v1/transfers/eligibility/{domainName}","href":"/api/v1/reference/transfers/get-transfer-eligibility"},{"group":"External","pages":[{"title":"List Transfers","openapi":"get /core/v1/transfers","href":"/api/v1/reference/transfers/list-transfers"},{"title":"Get Transfer Status","openapi":"get /core/v1/transfers/{domainName}","href":"/api/v1/reference/transfers/get-transfer"},{"title":"Create External Transfer In","openapi":"post /core/v1/transfers","href":"/api/v1/reference/transfers/create-transfer"},{"title":"Cancel External Transfer In","openapi":"post /core/v1/transfers/{domainName}:cancel","href":"/api/v1/reference/transfers/cancel-transfer"},{"title":"Cancel External Transfer Out","openapi":"post /core/v1/transfers/external/out/{domainName}:cancel","href":"/api/v1/reference/transfers/cancel-external-transfer-out"}]},{"group":"Internal","pages":[{"title":"Create Internal Transfer In","openapi":"post /core/v1/transfers/internal/in","href":"/api/v1/reference/transfers/create-internal-transfer-in"}]}]},{"group":"URL Forwardings","pages":[{"openapi":"post /core/v1/domains/{domainName}/url/forwarding","title":"Create URLForwarding","href":"/api/v1/reference/url-forwardings/create-urlforwarding"},{"openapi":"get /core/v1/urlforwarding/{domainName}","title":"List URL Forwardings by domain","href":"/api/v1/reference/url-forwardings/list-urlforwardings-by-domain"},{"openapi":"get /core/v1/urlforwarding/{domainName}/{id}","title":"Get URL Forwarding by ID","href":"/api/v1/reference/url-forwardings/get-urlforwarding-by-id"},{"openapi":"patch /core/v1/urlforwarding/{domainName}/{id}","title":"Update URL Forwarding by ID","href":"/api/v1/reference/url-forwardings/update-urlforwarding-by-id"},{"openapi":"delete /core/v1/urlforwarding/{domainName}/{id}","title":"Delete URL Forwarding by ID","href":"/api/v1/reference/url-forwardings/delete-urlforwarding-by-id"},{"openapi":"get /core/v1/domains/{domainName}/url/forwarding","deprecated":true,"title":"List URLForwardings","href":"/api/v1/reference/url-forwardings/list-urlforwardings"},{"openapi":"get /core/v1/domains/{domainName}/url/forwarding/{host}","deprecated":true,"title":"Get URLForwarding","href":"/api/v1/reference/url-forwardings/get-urlforwarding"},{"openapi":"put /core/v1/domains/{domainName}/url/forwarding/{host}","deprecated":true,"title":"Update URLForwarding","href":"/api/v1/reference/url-forwardings/update-urlforwarding"},{"openapi":"delete /core/v1/domains/{domainName}/url/forwarding/{host}","deprecated":true,"title":"Delete URLForwarding","href":"/api/v1/reference/url-forwardings/delete-urlforwarding"}]},{"group":"Vanity Nameservers","pages":[{"openapi":"get /core/v1/domains/{domainName}/vanity_nameservers","title":"List Vanity Nameservers","href":"/api/v1/reference/vanity-nameservers/list-vanity-nameservers"},{"openapi":"post /core/v1/domains/{domainName}/vanity_nameservers","title":"Create Vanity Nameserver","href":"/api/v1/reference/vanity-nameservers/create-vanity-nameserver"},{"openapi":"get /core/v1/domains/{domainName}/vanity_nameservers/{hostname}","title":"Get Vanity Nameserver","href":"/api/v1/reference/vanity-nameservers/get-vanity-nameserver"},{"openapi":"put /core/v1/domains/{domainName}/vanity_nameservers/{hostname}","title":"Update Vanity Nameserver IP","href":"/api/v1/reference/vanity-nameservers/update-vanity-nameserver-ip"},{"openapi":"delete /core/v1/domains/{domainName}/vanity_nameservers/{hostname}","title":"Delete Vanity Nameserver","href":"/api/v1/reference/vanity-nameservers/delete-vanity-nameserver"}]},{"group":"Webhook Notifications","pages":[{"title":"Webhooks Overview","href":"/api/v1/reference/webhook-notifications/overview"},{"group":"Subscriptions","pages":[{"title":"Get Subscribed Notifications","openapi":"get /core/v1/notifications","description":"Retrieves all active webhook subscriptions on the account.","href":"/api/v1/reference/webhook-notifications/get-subscribed-notifications"},{"title":"Subscribe to Notification","openapi":"post /core/v1/notifications","href":"/api/v1/reference/webhook-notifications/subscribe-to-notification"},{"title":"Modify Subscription","openapi":"put /core/v1/notifications/{id}","description":"Updates an existing webhook’s configuration. This may include changing the callback URL or updating whether the webhook is currently active.","href":"/api/v1/reference/webhook-notifications/modify-subscription"},{"title":"Delete Subscription","openapi":"delete /core/v1/notifications/{id}","href":"/api/v1/reference/webhook-notifications/delete-subscription"}]},{"group":"Account Events","pages":[{"title":"Account Credit Balance Change","openapi":"webhook accountCreditBalanceChange","href":"/api/v1/reference/webhook-notifications/account-credit-balance-change"}]},{"group":"Contact Events","pages":[{"title":"Contact Verification Status Change","openapi":"webhook contactVerificationStatusChange","href":"/api/v1/reference/webhook-notifications/contact-verification-status-change"}]},{"group":"Domain Events","pages":[{"title":"Domain Expiration","openapi":"webhook domainExpiration","href":"/api/v1/reference/webhook-notifications/domain-expiration"},{"title":"Domain Lock Status Change","openapi":"webhook domainLockStatusChange","href":"/api/v1/reference/webhook-notifications/domain-lock-status-change"},{"title":"Domain Registry Compliance Notice","openapi":"webhook domainRegistryComplianceNotice","href":"/api/v1/reference/webhook-notifications/domain-registry-compliance-notice"},{"title":"Domain Registry Rejection","openapi":"webhook domainRegistryRejection","href":"/api/v1/reference/webhook-notifications/domain-registry-rejection"},{"title":"Domain Removal","openapi":"webhook accountDomainRemoval","href":"/api/v1/reference/webhook-notifications/account-domain-removal"}]},{"group":"Transfers — External","pages":[{"title":"Domain Transfer In Status Change","openapi":"webhook domainTransferStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-status-change"},{"title":"Domain Transfer Out Status Change","openapi":"webhook domainTransferOutStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-out-status-change"}]},{"group":"Transfers — Internal","pages":[{"title":"Internal Transfer In Status Change","openapi":"webhook domainTransferInternalInStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-internal-in-status-change"},{"title":"Internal Transfer Out Status Change","openapi":"webhook domainTransferInternalOutStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-internal-out-status-change"}]}]}]},{"group":"Resources","pages":[{"title":"FAQ \u0026 Troubleshooting","href":"/resources/faq"},{"title":"Changelog","href":"/api/v1/changelog"}]}]},"basePath":"","title":"Subscribe to Notification - name.com Core API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}