Create property list

​

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

​

Lists that apply to every campaign

• appliesToAllCampaigns: true (the default) makes the list the advertiser’s all-campaigns list for its purpose (for the channels in filters.channels_any, or every channel when omitted). An advertiser has one all-campaigns list per purpose, so the new list replaces the previous one, and the response names it in replacedPropertyListIds. The replaced list stays saved but applies to no campaign (its appliesToAllCampaigns becomes false); a list still used in other channels is not replaced. Active media buys are moved from the replaced list to the new one straight away, and the response’s cascadeSummary reports how many.
• If no list slot covers the list’s channels (the advertiser’s brand has no list slots, or none for the channels in filters.channels_any), a default create cannot apply the list: it is saved for campaign use only, returned with appliesToAllCampaigns: false, and nothing is replaced or pushed (cascadeSummary reports zero media buys).
• 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).

​

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"
  }
}

​

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.

​

Related