1. Domains
ResellerStack Developer API
  • Introduction
  • Quick start
  • API Reference
    • Customers
      • List customers
      • Create customer
      • Get customer
      • Update customer notes
      • Update customer status
      • Update billing details
    • Geo
      • List countries
      • List states
    • Pricing
      • List TLD pricing
      • Update TLD pricing
      • Set TLD featured
      • Apply bulk margin
      • Reorder TLD pricing
    • Domains
      • List domains
        GET
      • Check domain availability
        POST
      • Register a domain
        POST
      • Checkout domain cart (bulk)
        POST
      • Toggle WHOIS privacy
        PATCH
      • Update domain contacts
        PATCH
      • Get domain
        GET
      • Toggle transfer lock
        PATCH
      • Toggle auto-renew
        PATCH
      • Preview renewal price
        GET
      • Renew domain now
        POST
      • Register a domain with Google Workspace
        POST
      • List bundle offers for a name
        GET
      • Register a bundle
        POST
    • Contacts
      • List contacts
      • Create contact
      • Get contact
    • Orders
      • List orders
      • Get order
    • DNS
      • List DNS records
      • Add DNS records
      • Update DNS record
      • Delete DNS record
      • Update nameservers
      • Reset nameservers
      • List DNSSEC records
      • Add DNSSEC record
      • Delete DNSSEC record
    • Wallet
      • Get wallet balance
    • Webhooks
      • workspace.pastdue
      • workspace.expired
      • workspace.txt.failed
      • workspace.renewed
      • workspace.provisioned
      • workspace.txt.ready
      • workspace.txt.propagated
      • workspace.licenses.increased
      • workspace.deleted
      • workspace.failed
      • mailbox.ready
      • mailbox.deleted
      • workspace.dkim.ready
      • workspace.dkim.propagated
      • workspace.domain.swapped
      • Delivered when domain.order.success fires
      • Delivered when domain.order.failed fires
      • Delivered when domain.renewal.success fires
      • Delivered when domain.renewal.failed fires
    • GWS
      • Google Workspace ~ Creation Flow
      • Google Workspace ~ Sandbox Environment
      • Check Workspace Exists
      • Create Workspace
      • List Workspaces
      • Delete Workspace
      • Check DNS Propagation
      • Renew Workspace
      • Change Primary Domain (Beta)
    • Licenses & Mailboxes
      • Create Mailbox
      • List Mailboxes
      • Delete Mailboxes
      • Decrease Seats
  • Health check
    GET
  • Get current partner
    GET
  1. Domains

Update domain contacts

Production
https://api.resellerstack.ai/api/v1
Production
https://api.resellerstack.ai/api/v1
PATCH
/domains/{id}/contacts
Assigns saved contacts (see POST /contacts) to this domain's registrant, admin, tech and billing roles in a single call. {id} accepts either the domain's ResellerStack id or its domain name.
Prefer this over PATCH /domains/{id}/contacts/{role}. Registrars require every role to be submitted together, so setting four roles one at a time repeats the same work four times and leaves a window where a failure part-way through has applied some roles but not others. This endpoint applies them in one registrar round trip.
Include any subset of the four roles - the ones you leave out keep whatever they hold today. The same contact id can be reused across roles and across domains.

Request

Authorization
API Key
Add parameter in header
rs-x-api-key
Example:
rs-x-api-key: ********************
or
Path Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Domain contacts updated
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🟠422Parameter Error
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request PATCH 'https://api.resellerstack.ai/api/v1/domains//contacts' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contacts": {
        "registrant": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "admin": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "tech": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "billing": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
}'
Response Response Example
200 - Example 1
{
    "status": 200,
    "message": "Domain contacts updated",
    "data": null
}
Modified at 2026-10-22 08:25:43
Previous
Toggle WHOIS privacy
Next
Get domain
Built with