Skip to main content
PATCH /api/v2/accounts/{customerId}/domain Sets the registered domain on an account. The domain gates domain auto-join and, for seller accounts, ties the account to its storefront. Requires the ADMIN role on the target account (direct membership, organization admin via the hierarchy, or SuperAdmin).

​
Why buyers should set it

For buyer accounts, the registered domain is the buying organization sellers see. Interchange sends it as the AdCP account.operator on every account-scoped task (product discovery, account setup, booking, updates, cancellations, and delivery reporting), and sellers key their account for you on the pair of that operator domain and the advertised brand’s domain. The account they open under that key is what carries your credit terms, approval state, and invoices with them. Until an account has a registered domain, Interchange identifies it as interchange.io, meaning the buy is operating through the platform rather than under your own organization. That is accurate but less specific than sellers usually want, and every buyer without a domain shares one seller-side account. Setting your domain moves your activity onto an account in your own name. Setting or changing the domain changes that key, so a seller you already transact with will see a new account on the next task. Existing media buys stay on the account they were created under. Coordinate the change with any seller you have live buys with.

​
Request

curl

​
Parameters

​
Response

​
Errors

  • 400 VALIDATION_ERROR — malformed customerDomain.
  • 401 UNAUTHORIZED — caller is not an ADMIN on the target account.
See Errors for the full error contract.

Account tasks

All account operations

Update membership

Enable domain auto-join

Account overview

Domain and hierarchy concepts