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 has expired and entered the post-expiry grace period.

Payload sent when a domain in the subscribing account expires and the grace period starts. This event is informational; it is separate from lock, removal, and transfer-out events.

​
eventName
enum<string>
required

The name of the subscription event.

Available options:
domain.expiration
​
domainName
string
required

The name of the expired domain.

Example:

"example.com"

​
expirationDate
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.