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

Payload sent when a domain transfers OUT from the webhook subscriber's account to another name.com account.

eventName
enum<string>
required

The name of the subscription event.

Available options:
domain.transfer.internal_out
sourceAccountId
integer<int32>
required

The account id that previously owned the domain (the losing account).

Example:

12345

destinationAccountId
integer<int32>
required

The account id that now owns the domain (the gaining account).

Example:

54321

status
enum<string>
required
Available options:
completed
occurredAt
string<date-time>
required

When the domain transfer out occurred.

Example:

"2023-04-01T12:00:00Z"

domain
object
required

The response format for a domain.

transferId
integer<int32>

The internal transfer ID for this move, when available. Omitted when no transfer ID has been assigned for the event.

Example:

67890

Response

The subscribed server accepted the request.