Update Domain Contact Details

POST

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

Maintainer:Not configured

Update the WHOIS contact details for a domain registered through InboxKit. The details you send are applied to all four contact roles on the domain: registrant, administrative, technical and billing.

The contact email address cannot be set through this endpoint. InboxKit keeps a monitored address on the record so that required registry and transfer notices are always received; sending an email field fails validation.

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

A 200 covers three outcomes — read data.status:

updated — the new details are in effect.

no_change — the details already matched, nothing was changed.

pending_approval — the change was accepted and is awaiting email approval from the current contact, which ICANN requires for a registrant change. This usually completes within a few hours.

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/contacts' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "uid": "dom-123e4567-e89b-12d3-a456-426614174000",
    "contact_details": {
        "first_name": "John",
        "last_name": "Doe",
        "phone": "+1.4155550123",
        "organization": "Acme Inc",
        "address_line1": "123 Market Street",
        "address_line2": "Suite 400",
        "city": "San Francisco",
        "state": "California",
        "country": "US",
        "postal_code": "94105"
    }
}'

Response Example

200 - Example 1

{
    "error": false,
    "message": "Domain contacts updated successfully.",
    "data": {
        "domain": "example.com",
        "status": "updated"
    }
}

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

Update Domain Privacy

Connect Cloudflare Domains