Create property list

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

POST /api/v2/buyer/advertisers/{advertiserId}/property-lists Creates a named property list scoped to an advertiser. Submit website domains via the domains shorthand, mixed web/mobile/CTV identifiers via identifiers, or both. Identifiers are resolved against the AAO registry and local catalog; the response carries a resolutionSummary showing how many will actually target.

Request

curl -X POST https://api.apostra.com/api/v2/buyer/advertisers/12345/property-lists \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q1 Campaign - UK Premium",
    "purpose": "include",
    "domains": ["example-times.com", "example-press.co.uk", "example-news.com"],
    "filters": { "channels_any": ["display", "olv"] }
  }'

{
  "name": "Cross-screen premium",
  "purpose": "include",
  "identifiers": [
    { "type": "domain", "value": "example-times.com" },
    { "type": "ios_bundle", "value": "com.exampletimes.ExampleTimes" },
    { "type": "android_package", "value": "com.exampletimes.android" },
    { "type": "roku_store_id", "value": "12" }
  ]
}

Parameters

Field	Type	Required	Notes
`advertiserId`	string	Yes	Path. Owning advertiser
`name`	string	Yes	List name (1–255 chars)
`purpose`	enum	Yes	`include` (only buy these) or `exclude` (never buy these)
`domains`	string[]	No	Shorthand for `identifiers` of `type: "domain"`. Up to 100,000
`identifiers`	object[]	No	Typed `{ type, value }`. `type` is `domain`, `subdomain`, `ios_bundle`, `android_package`, `apple_app_store_id`, `google_play_id`, `roku_store_id`, `fire_tv_asin`, `samsung_app_id`, `apple_tv_bundle`, or `bundle_id`. Up to 100,000
`filters`	object	No	AdCP property-list filters, stored with the list. `channels_any` is AdCP’s channel filter: a property should support at least one of the channels (`display`, `olv`, `social`, `ctv`, `dooh`, and more). It does not limit which channels or campaigns the list applies to. `feature_requirements` (for example “quality score at least 20”) keeps only the properties whose scores meet it, for accounts on the V3 beta feature profile; other accounts are refused with `501 NOT_IMPLEMENTED`. The scores themselves are saved with a V3 `save_property_list` call. See Property scores
`appliesToAllCampaigns`	boolean	No	Defaults to `true`. See Lists that apply to every campaign. Set on create only

Provide domains, identifiers, or both — the combined total must be 1–100,000. They are concatenated and deduplicated.

Lists that apply to every campaign

Every property list belongs to the advertiser it was created for.

appliesToAllCampaigns: true (the default) makes the list the advertiser’s all-campaigns list for its purpose, in every channel. An advertiser has one all-campaigns list per purpose, so the new list replaces the previous ones, and the response names them in replacedPropertyListIds. A replaced list stays saved but applies to no campaign (its appliesToAllCampaigns becomes false). Active media buys are moved from the replaced list to the new one straight away, and the response’s cascadeSummary reports how many.
appliesToAllCampaigns: false saves the list for the advertiser without applying it to any campaign. The advertiser’s lists and every active media buy stay as they were, and the response has no cascadeSummary. Apply it to one campaign by setting it as that campaign’s own list (see Campaign lists).

The choice is fixed when the list is created. GET and list responses return appliesToAllCampaigns for lists that carry an owner record for the requested advertiser.

Response

{
  "propertyList": {
    "listId": "42",
    "name": "Cross-screen premium",
    "purpose": "include",
    "identifiers": [
      { "type": "domain", "value": "example-times.com" },
      { "type": "ios_bundle", "value": "com.exampletimes.ExampleTimes" },
      { "type": "android_package", "value": "com.exampletimes.android" }
    ],
    "unresolvedIdentifiers": [{ "type": "roku_store_id", "value": "12" }],
    "registeredIdentifiers": [],
    "domains": ["example-times.com"],
    "unresolvedDomains": [],
    "registeredDomains": [],
    "propertyCount": 14,
    "resolutionSummary": {
      "totalRequested": 4,
      "resolvedCount": 3,
      "registeredCount": 0,
      "unresolvedCount": 1,
      "resolutionRate": 0.75
    },
    "appliesToAllCampaigns": true,
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-15T10:30:00.000Z"
  }
}

identifiers is the persisted resolved set. unresolvedIdentifiers and registeredIdentifiers are transient — they appear on create/update only, not on subsequent GETs. Always inspect resolutionSummary: a non-zero unresolvedCount means those identifiers will not target.

Errors

400 VALIDATION_ERROR — missing name or purpose, empty identifier set, or combined total above 100,000.
404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated account.

See Errors for the full error contract.

Property list tasks

All property list operations

Property Lists guide

Identifier types, resolution, and concepts

Check property list

Validate a candidate set before creating

Update property list

Replace identifiers on an existing list

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Create property list

Request

Parameters

Lists that apply to every campaign

Response

Errors

Property list tasks

Property Lists guide

Check property list

Update property list

​Request

​Parameters

​Lists that apply to every campaign

​Response

​Errors

​Related

Property list tasks

Property Lists guide

Check property list

Update property list

Request

Parameters

Lists that apply to every campaign

Response

Errors

Related