Skip to main content

​
✨ Create a Creative

Creates a new creative for an advertiser.

​
📤 Request Example

curl -X POST https://betaapi.audiohook.com/v2/companies/:companyUUID/creatives \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "request_headers": [
      { "name": "X-Request-Header", "value": "Header value" }
    ],
    "body": {
      "creative_name": "Snarkys 30 sec Christmas spot",
      "advertiser_id": "1234-abcd-qwer-xcvb",
      "status": true,
      "filename": "my-great-audio-ad.wav",
      "tags": [...],
      "start_flight_date": "2022-12-01",
      "end_flight_date": "2023-01-01",
      "events": [...],
      "companion_ad": {
        "click_through_url": "https://snarkyspizza.com/...",
        "display_asset_filename": "eat-at-snarkys-christmas-spot.png"
      }
    }
  }'

​
✅ Response Example

{
  "creativeId": 9999,
  "s3_data": { ... },
  "s3_displayad": { ... }
}

​
🌐 HTTP Request

POST /v2/companies/:companyUUID/creatives

​
🧾 Body Parameters

ParameterRequiredTypeDescription
creative_name✅stringName of the creative.
advertiser_id✅stringAdvertiser UUID.
status✅booleanActive status for use in campaigns.
filename✅stringFilename including extension.
tags❌arrayTags to categorize creative.
start_flight_date❌stringStart date in Y-M-D.
end_flight_date❌stringEnd date in Y-M-D.
events❌arrayPixel events to attach.
companion_ad❌objectCompanion display ad.