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

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
​
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

Response

Update advertiser