Skip to main content
PUT
/
advertisers
/
{advertiserId}
Update advertiser
curl --request PUT \
  --url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.interchange.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key or access token

Path Parameters

​
advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Body

application/json

Request body for updating an advertiser

​
name
string

Updated name of the advertiser

Required string length: 1 - 255
Example:

"Acme Corporation"

​
description
string

Updated description of the advertiser

Maximum string length: 1000
Example:

"Updated description for Acme Corporation"

​
brand
string

Updated brand domain (e.g., "nike.com"). Re-resolves brand identity from /.well-known/brand.json or the AdCP registry.

Minimum string length: 1
Example:

"nike.com"

​
linkedAccounts
object[]

Accounts to add to this advertiser. Existing linked accounts are not removed.

​
optimizationApplyMode
enum<string>

Default mode for applying Scope3 AI model optimizations to media buys for campaigns under this advertiser. When set to "AUTO", optimizations are applied automatically; when "MANUAL", they require approval.

Available options:
AUTO,
MANUAL
​
campaignBudgetType
enum<string>

How budget is allocated by campaign. "total_budget" means the campaign budget covers both media spend and fees.

Available options:
total_budget
​
utmConfig
object[]

Default UTM (Urchin Tracking Module) parameters for this advertiser. Replaces all existing seat-level UTM params. Pass an empty array to clear.

Maximum array length: 20
​
dataDelivery
object

Data-delivery configuration for this advertiser. Groups standing Data Delivery Outputs (and, in a follow-up, the destination credentials they reference). Omit to leave existing config untouched.

​
frequencyCaps
object[]

Buyer-side frequency cap configs to apply to this advertiser. When provided, replaces all existing non-archived caps for this advertiser (pass an empty array to clear). Omit to leave existing caps untouched.

Response

Update advertiser