Advertiser

An advertiser is the brand a buyer account purchases media for. Campaigns, creatives and delivery all belong to an advertiser, and its settings are the defaults every campaign starts from.

Key fields

integer

required

Stable numeric id. Tools accept it as a number or an integer string.

string

required

Display name, for example “Wrenfield Coffee Co.”.

string

The brand’s domain (for example wrenfieldcoffee.test). Used to resolve the brand card and to identify the brand to sellers.

object

The resolved brand card: name, logo, colors, industry, tagline and tone. Semi and the creative composer use the tone when writing copy.

string

required

ISO 4217 code. Every campaign budget uses it. It locks after the first campaign, so confirm it before creating.

boolean

required

Sandbox advertisers run the whole loop with simulated delivery and no real spend. Fixed at creation.

array

Preferred markets (ISO 3166-1 alpha-2) and channels. New campaigns start with these.

enum

ACTIVE or ARCHIVED. Archived advertisers can be restored.

object

Defaults for new campaigns: inventorySelection and rebriefing, each manual, propose or automatic.

Brand lookup

Before creating, preview the brand card without saving anything:

save_advertiser

{ "resolveBrand": "wrenfieldcoffee.test" }

Semicola checks the AdCP brand registry and the domain’s /.well-known/brand.json. The preview is never stored.

Create, update, archive

{
  "name": "Wrenfield Coffee Co.",
  "brand": "wrenfieldcoffee.test",
  "primaryCurrency": "USD",
  "sandbox": true,
  "brandCountries": ["US"],
  "idempotencyKey": "wrenfield-advertiser-create-0001"
}

{ "advertiserIds": [12], "isArchived": true }

If a required field is missing, save_advertiser returns needs_input with a question. Check the exact shapes in the v3 Tool Catalog.

Start here

Buy media

Sell media

Help

Key fields

Brand lookup

Create, update, archive

​Key fields

​Brand lookup

​Create, update, archive

Key fields

Brand lookup

Create, update, archive