Update account domain

PATCH /api/v2/accounts/{customerId}/domain Updates an account’s registered domain. The domain gates domain auto-join membership and supplies the operator domain on outbound AdCP account references. Requires ADMIN role on the target account (direct membership, organization admin via the hierarchy, or SuperAdmin).

If a buyer account has no registered domain, current v2 outbound AdCP calls use interchange.io as the operator. This platform fallback lets the account transact, but it is not the buyer’s durable identity: accounts sharing the fallback can collapse onto the same seller-side natural key. Record the buying organization’s real domain before production activity.

Request

curl

curl -X PATCH https://api.interchange.io/api/v2/accounts/200/domain \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerDomain": "acmeretail.com"
  }'

Parameters

Field	In	Type	Required	Notes
`customerId`	path	string	Yes	ID of the account to update
`customerDomain`	body	string	Yes	Registered domain for the account (max 255, valid hostname pattern)

Response

{
  "id": 200,
  "customerDomain": "acmeretail.com",
  "customerDomainApproved": true
}

Field	Type	Notes
`id`	integer	Account ID
`customerDomain`	string \| null	Registered domain on the account
`customerDomainApproved`	boolean	Whether the domain was automatically verified (true when an active member’s email matches the new domain)

Errors

400 VALIDATION_ERROR — customerDomain fails the hostname pattern.
401 UNAUTHORIZED — missing or invalid bearer token.
403 FORBIDDEN — caller is not an ADMIN on the target account.

See Errors for the full error contract.

Account tasks

All account operations

Update membership

Toggle domain auto-join

Get current account

Your current context

List accounts Update membership settings

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Account tasks

Update membership

Get current account

​Request

​Parameters

​Response

​Errors

​Related

Account tasks

Update membership

Get current account

Request

Parameters

Response

Errors

Related