Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Webhook Notifications

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).
  • 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 to another registrar; fires when the domain is removed from the account.
  • 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.expiration – domain has expired and entered the post-expiry grace period. This is informational only.
post/core/v1/notifications

Request body

eventName'account.credit.balance_change' | '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.expiration' required

The list of configured webhooks you can subscribe to

urlstring required

The URL we will send the notification data to

activeboolean required

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.

Example request

{
  "url": "https://example.com"
}

Response

A successful response.