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.

Response

Create advertiser