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

Authorizations

​
Authorization
string
header
required

API key or access token

Body

application/json

Request body for creating a new advertiser

​
name
string
required

Name of the advertiser

Required string length: 1 - 255
Example:

"Acme Corp"

​
brand
string
required

Brand domain (e.g., "nike.com") or full URL to brand manifest. Brand identity is resolved from /.well-known/brand.json or the AdCP registry.

Minimum string length: 1
Example:

"nike.com"

​
description
string

Optional description of the advertiser

Maximum string length: 1000
Example:

"Global advertising account for Acme Corporation"

​
saveBrand
boolean
default:false

When true, auto-saves an enriched brand to the AdCP registry if the brand is not yet registered. Set this after reviewing the enriched brand preview returned from a previous attempt.

​
linkedAccounts
object[]

Accounts to link to this advertiser at creation time. Each entry references a discovered account from a partner.

​
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. Defaults to "MANUAL".

Available options:
AUTO,
MANUAL
​
sandbox
boolean
default:false

When true, this advertiser operates in sandbox mode. All ADCP operations will use sandbox-flagged accounts — no real platform calls, no real spend. Cannot be changed after creation.

​
utmConfig
object[]

Default UTM (Urchin Tracking Module) parameters for this advertiser. These are appended to landing page URLs during clickthrough redirection. Campaign-level UTM config can override these per param key.

Maximum array length: 20

Response

Create advertiser