Create Creative

Create a new creative. creative_type determines which fields apply - media_file creatives reference an uploaded video (see Get Creative Upload URL), vast_url creatives reference a third-party VAST tag.

curl -X POST "https://api.5centscdn.com/v2/ad-manager/101/creatives" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "name": "Summer 30s Spot",
  "creative_type": "media_file",
  "duration_seconds": 30,
  "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4",
  "vast_url": "https://ads.example.com/vast?id=123",
  "click_url": "https://acmecorp.com/summer-sale",
  "mime_type": "video/mp4",
  "width": 1920,
  "height": 1080,
  "bitrate": 4000000,
  "tracking_mode": "proxy",
  "vast_query_params": [
    {
      "name": "cachebuster",
      "type": "from-variable",
      "value": "${CACHE_BUSTER}"
    }
  ],
  "ad_origin": {
    "customHeaders": [
      {
        "name": "X-Custom-Auth",
        "value": "secret-token"
      }
    ]
  },
  "skip_override": {
    "skippable": true,
    "offset_type": "seconds",
    "offset_value": 5
  },
  "metadata": {}
}'

import requests
import json

url = "https://api.5centscdn.com/v2/ad-manager/101/creatives"
headers = {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}
data = {
  "name": "Summer 30s Spot",
  "creative_type": "media_file",
  "duration_seconds": 30,
  "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4",
  "vast_url": "https://ads.example.com/vast?id=123",
  "click_url": "https://acmecorp.com/summer-sale",
  "mime_type": "video/mp4",
  "width": 1920,
  "height": 1080,
  "bitrate": 4000000,
  "tracking_mode": "proxy",
  "vast_query_params": [
    {
      "name": "cachebuster",
      "type": "from-variable",
      "value": "${CACHE_BUSTER}"
    }
  ],
  "ad_origin": {
    "customHeaders": [
      {
        "name": "X-Custom-Auth",
        "value": "secret-token"
      }
    ]
  },
  "skip_override": {
    "skippable": true,
    "offset_type": "seconds",
    "offset_value": 5
  },
  "metadata": {}
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://api.5centscdn.com/v2/ad-manager/101/creatives", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
},
  body: JSON.stringify({
  "name": "Summer 30s Spot",
  "creative_type": "media_file",
  "duration_seconds": 30,
  "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4",
  "vast_url": "https://ads.example.com/vast?id=123",
  "click_url": "https://acmecorp.com/summer-sale",
  "mime_type": "video/mp4",
  "width": 1920,
  "height": 1080,
  "bitrate": 4000000,
  "tracking_mode": "proxy",
  "vast_query_params": [
    {
      "name": "cachebuster",
      "type": "from-variable",
      "value": "${CACHE_BUSTER}"
    }
  ],
  "ad_origin": {
    "customHeaders": [
      {
        "name": "X-Custom-Auth",
        "value": "secret-token"
      }
    ]
  },
  "skip_override": {
    "skippable": true,
    "offset_type": "seconds",
    "offset_value": 5
  },
  "metadata": {}
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "name": "Summer 30s Spot",
  "creative_type": "media_file",
  "duration_seconds": 30,
  "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4",
  "vast_url": "https://ads.example.com/vast?id=123",
  "click_url": "https://acmecorp.com/summer-sale",
  "mime_type": "video/mp4",
  "width": 1920,
  "height": 1080,
  "bitrate": 4000000,
  "tracking_mode": "proxy",
  "vast_query_params": [
    {
      "name": "cachebuster",
      "type": "from-variable",
      "value": "${CACHE_BUSTER}"
    }
  ],
  "ad_origin": {
    "customHeaders": [
      {
        "name": "X-Custom-Auth",
        "value": "secret-token"
      }
    ]
  },
  "skip_override": {
    "skippable": true,
    "offset_type": "seconds",
    "offset_value": 5
  },
  "metadata": {}
}`)

    req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/ad-manager/101/creatives", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api.5centscdn.com/v2/ad-manager/101/creatives')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'YOUR_API_KEY'
request.body = '{
  "name": "Summer 30s Spot",
  "creative_type": "media_file",
  "duration_seconds": 30,
  "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4",
  "vast_url": "https://ads.example.com/vast?id=123",
  "click_url": "https://acmecorp.com/summer-sale",
  "mime_type": "video/mp4",
  "width": 1920,
  "height": 1080,
  "bitrate": 4000000,
  "tracking_mode": "proxy",
  "vast_query_params": [
    {
      "name": "cachebuster",
      "type": "from-variable",
      "value": "${CACHE_BUSTER}"
    }
  ],
  "ad_origin": {
    "customHeaders": [
      {
        "name": "X-Custom-Auth",
        "value": "secret-token"
      }
    ]
  },
  "skip_override": {
    "skippable": true,
    "offset_type": "seconds",
    "offset_value": 5
  },
  "metadata": {}
}'

response = http.request(request)
puts response.body

{
  "result": "success",
  "creative": {
    "id": "crv_9a71",
    "admanager_id": 9071,
    "name": "Summer 30s Spot",
    "creative_type": "media_file",
    "status": "active",
    "approval_status": "pending",
    "duration_seconds": 30,
    "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4",
    "vast_url": "https://ads.example.com/vast?id=123",
    "click_url": "https://acmecorp.com/summer-sale",
    "mime_type": "video/mp4",
    "width": 1920,
    "height": 1080,
    "bitrate": 4000000,
    "tracking_mode": "proxy",
    "vast_query_params": [
      {
        "name": "cachebuster",
        "type": "from-variable",
        "value": "${CACHE_BUSTER}"
      }
    ],
    "ad_origin": {
      "customHeaders": [
        {
          "name": "X-Custom-Auth",
          "value": "secret-token"
        }
      ]
    },
    "skip_override": {
      "skippable": true,
      "offset_type": "seconds",
      "offset_value": 5
    },
    "metadata": [],
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-15T10:30:00Z"
  }
}

POST

/ad-manager/{pid}/creatives

POST

Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)

X-API-Keystring

Required

API key (sent in header)

path

pidinteger

Required

ID of the Ad Manager project.

Content-Typestring

Required

The media type of the request body

Options: application/json

Max length: 120

Options: media_file, vast_url

duration_secondsnumber

Required for media_file creatives. Maximum 180 seconds.

media_urlstring

Required for media_file creatives. Set from object_url returned by the upload-url endpoint.

vast_urlstring

Required for vast_url creatives.

Options: proxy, passthrough

vast_query_paramsarray

ad_originobject

skip_overridestring

metadataobject

Request Preview

Response

Response will appear here after sending the request

Authentication

header

X-API-Keystring

Required

API Key for authentication. Provide your API key in the header.

Path Parameters

pidinteger

Required

ID of the Ad Manager project.

Example:

101

Body

application/json

namestring

Required

Example:

Summer 30s Spot

creative_typestring

Required

Allowed values:media_filevast_url

duration_secondsnumber

Required for media_file creatives. Maximum 180 seconds.

Example:

30

media_urlstring

Required for media_file creatives. Set from object_url returned by the upload-url endpoint.

Example:

https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4

vast_urlstring

Required for vast_url creatives.

Example:

https://ads.example.com/vast?id=123

click_urlstring

Example:

https://acmecorp.com/summer-sale

mime_typestring

Example:

video/mp4

widthinteger

Example:

1920

heightinteger

Example:

1080

bitrateinteger

Example:

4000000

tracking_modestring

Allowed values:proxypassthrough

vast_query_paramsarray

ad_originobject

skip_overridestring

metadataobject

Responses

resultstring

Operation outcome.

Allowed values:successerror

creativeobject

Was this page helpful?

curl -X POST "https://api.5centscdn.com/v2/ad-manager/101/creatives" \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{ "name": "Summer 30s Spot", "creative_type": "media_file", "duration_seconds": 30, "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4", "vast_url": "https://ads.example.com/vast?id=123", "click_url": "https://acmecorp.com/summer-sale", "mime_type": "video/mp4", "width": 1920, "height": 1080, "bitrate": 4000000, "tracking_mode": "proxy", "vast_query_params": [ { "name": "cachebuster", "type": "from-variable", "value": "${CACHE_BUSTER}" } ], "ad_origin": { "customHeaders": [ { "name": "X-Custom-Auth", "value": "secret-token" } ] }, "skip_override": { "skippable": true, "offset_type": "seconds", "offset_value": 5 }, "metadata": {} }'

{ "result": "success", "creative": { "id": "crv_9a71", "admanager_id": 9071, "name": "Summer 30s Spot", "creative_type": "media_file", "status": "active", "approval_status": "pending", "duration_seconds": 30, "media_url": "https://cdn.5centscdn.com/ad-manager-uploads/abc123.mp4", "vast_url": "https://ads.example.com/vast?id=123", "click_url": "https://acmecorp.com/summer-sale", "mime_type": "video/mp4", "width": 1920, "height": 1080, "bitrate": 4000000, "tracking_mode": "proxy", "vast_query_params": [ { "name": "cachebuster", "type": "from-variable", "value": "${CACHE_BUSTER}" } ], "ad_origin": { "customHeaders": [ { "name": "X-Custom-Auth", "value": "secret-token" } ] }, "skip_override": { "skippable": true, "offset_type": "seconds", "offset_value": 5 }, "metadata": [], "created_at": "2026-01-15T10:30:00Z", "updated_at": "2026-01-15T10:30:00Z" } }