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 transfer out status changes.

Payload for domain.transfer_out.status_change. completed means the domain left name.com. canceled means the outbound transfer is no longer pending at the registry.

eventName
enum<string>
required

The name of the subscription event.

Available options:
domain.transfer_out.status_change
domainName
string
required

The domain whose outbound transfer status changed. For completed, the domain has left name.com; for initiated and canceled, it remains on the losing account.

Example:

"example.com"

status
enum<string>
required

initiated (pending out started), completed (domain removed), or canceled (no longer pending at the registry).

Available options:
initiated,
completed,
canceled
Example:

"completed"

registryClientId
string | null

The registry client ID associated with the domain at the time of transfer out, when available. This can help identify the gaining registrar at the registry.

Example:

"NAMECOM-123"

Response

The subscribed server accepted the request.