Skip to main content
POST
/
advertisers
/
{advertiserId}
/
creative-sets
Create creative set
curl --request POST \
  --url https://api.agentic.scope3.com/api/v2/buyer/advertisers/{advertiserId}/creative-sets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Summer 2025 Campaign Creatives"
}
'
{
  "creativeSet": {
    "id": "cs_abc123",
    "advertiserId": "12345",
    "name": "Summer 2025 Campaign Creatives",
    "status": "DRAFT",
    "assets": [
      {
        "name": "Hero Video 30s",
        "type": "video",
        "status": "PENDING",
        "url": "https://storage.example.com/videos/hero-30s.mp4",
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "tags": [
          "hero",
          "summer-campaign"
        ],
        "metadata": {
          "duration": 30,
          "width": 1920,
          "height": 1080,
          "codec": "h264",
          "bitrate": 5000
        }
      }
    ],
    "creatives": [
      {
        "name": "Display 300x250 - Summer Sale",
        "format": "display_banner",
        "assetIds": [
          "asset_123",
          "asset_456"
        ],
        "id": "<string>",
        "status": "DRAFT",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "macros": [
          {
            "key": "CLICK_URL",
            "required": false,
            "defaultValue": "https://example.com/landing",
            "description": "Landing page URL for click tracking"
          }
        ],
        "formatConfig": {}
      }
    ],
    "assetCount": 5,
    "creativeCount": 3,
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-20T14:45:00Z",
    "description": "<string>",
    "tags": [
      "<string>"
    ]
  }
}

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Body

application/json

Request body for creating a new creative set

name
string
required

Name of the creative set

Required string length: 1 - 255
Example:

"Summer 2025 Campaign Creatives"

description
string

Description of the creative set

Maximum string length: 2000
Example:

"Creative assets for the summer promotional campaign"

assets
object[]

Initial assets to include in the set

Video asset for creative sets

creatives
object[]

Initial creative definitions

tags
string[]

Tags for categorization

Example:
["summer", "promotional", "2025"]

Response

Create creative set

Response containing a single creative set

creativeSet
object
required

Creative set resource representation