Update Domain Privacy

POST

https://api.inboxkit.com/v1/api/domains/privacy

Maintainer:Not configured

Turn WHOIS privacy protection on or off for a domain registered through InboxKit.

With privacy protection on, the domain's public WHOIS record shows proxy details instead of the contact details on file. Turning it off publishes the real contact details.

Availability: the domain must be active and registered through InboxKit. Domains connected from an external registrar are managed at that registrar and return 422.

If the domain is already in the requested state the call still succeeds and returns data.status: "no_change" — nothing is changed, and the message says so.

Every change is recorded in the domain's change history.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success Response

application/json

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Not Found

🟠409Conflict

🟠422Unprocessable Entity

🔴502Bad Gateway

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/domains/privacy' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "uid": "dom-123e4567-e89b-12d3-a456-426614174000",
    "enable": true,
    "reason": "Customer requested privacy protection"
}'

Response Example

200 - Example 1

{
    "error": false,
    "message": "WHOIS privacy enabled successfully.",
    "data": {
        "domain": "example.com",
        "whois_privacy": true,
        "status": "updated"
    }
}

Modified at 2026-08-19 17:12:35

Check Renewal Status

Update Domain Contact Details