POST /v3/advertiser → advertiserCreate

Overview

Multi-step operations

POST /v3/advertiser accepts a wide REST body with inline bid lists, frequency configs, political profiles, and brands. advertiserCreate covers core advertiser provisioning only—not a 1:1 mirror of the REST body.

Inside REST associatedBidLists input, do not send read-only response fields: bidListSource, bidListAdjustmentType, bidListDimensions.

Input field mapping

Input type: AdvertiserCreateInput

Output field mapping

Output type: Advertiser (returned as data on AdvertiserCreatePayload)

Endpoint-specific nested types and enums

AdvertiserCategoryInput

Required on advertiserCreate.

CandidateProfile—REST input (no GraphQL inline equivalent)

REST CandidateProfiles[] is writable on POST /v3/advertiser but is not accepted on AdvertiserCreateInput. Configure political candidate data outside this mutation.

CandidateProfile—REST response on `Advertiser`

Brand—REST input (no GraphQL inline equivalent)

REST Brands[] is writable on POST /v3/advertiser but is not accepted on AdvertiserCreateInput.

Brand—REST response on `Advertiser`

Code examples

REST example

POST /v3/advertiser HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

{
  "PartnerId": "prt-123",
  "AdvertiserName": "Manual Test Advertiser",
  "DomainAddress": "https://example.com",
  "Country": "US",
  "AttributionClickLookbackWindowInSeconds": 864000,
  "AttributionImpressionLookbackWindowInSeconds": 86400,
  "ClickDedupWindowInSeconds": 0,
  "ConversionDedupWindowInSeconds": 0,
  "DefaultRightMediaOfferTypeId": 3,
  "AdvertiserCategory": { "CategoryId": 123 }
}

GraphQL example

POST /graphql HTTP/1.1
Content-Type: application/json
TTD-Auth: AUTH_TOKEN_PLACEHOLDER

mutation CreateAdvertiser($input: AdvertiserCreateInput!) {
  advertiserCreate(input: $input) {
    data {
      id
      name
      domainAddress
      partner { id }
    }
    errors {
      ... on AdvertiserValidationError {
        message
        field
      }
    }
  }
}

Variables:

{
  "input": {
    "partnerId": "prt-123",
    "name": "Manual Test Advertiser",
    "domainAddress": "https://example.com",
    "country": "US",
    "attributionClickLookbackWindowInSeconds": 864000,
    "attributionImpressionLookbackWindowInSeconds": 86400,
    "clickDedupeWindowInSeconds": 0,
    "conversionDedupeWindowInSeconds": 0,
    "defaultRightMediaOfferTypeId": 3,
    "advertiserCategoryInput": {
      "categoryId": 123
    }
  }
}

REST-inline fields such as associatedBidLists, candidateProfiles, and brands are not inputs on AdvertiserCreateInput. Use advertiserAssociateBidList and other dedicated mutations after create when REST parity is required.