Skip to main content
WEBHOOK

Authorizations

​
Authorization
string
header
required

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.

Headers

​
X-NAMECOM-SIGNATURE
string
required

HMAC signature for the request payload. See HMAC signing documentation for example code and detailed explanation of signing.

Example:

"djasfgafgflgsdfgdsfkhfhjas,12334782,1123-3423-4dss4-354"

Body

application/json

The request sent to your server when a domain is removed from the account.

Payload sent when a domain is removed from the subscribing account.

​
eventName
enum<string>
required

The name of the subscription event

Available options:
account.domain.removal
​
domainName
string
required

The name of the domain that was removed

Example:

"example.com"

​
reason
enum<string>
required

Why the domain left inventory: expiration (registry delete / post-expiry inventory loss), agp_refund (AGP refund delete), or administrative (ops/support removal).

Available options:
expiration,
agp_refund,
administrative
Example:

"expiration"

​
expireDate
string<date-time>
required

The date and time when the domain expired

Example:

"2026-08-15T00:00:00Z"

Response

The subscribed server accepted the request.