Skip to main content

​
🔄 Update a Creative

Updates an existing creative by ID.

​
📤 Request Example

curl -X PATCH https://betaapi.audiohook.com/v2/companies/:companyUUID/creatives/9999 \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "request_headers": [
      { "name": "X-Request-Header", "value": "Header value" }
    ],
    "body": {
      "creative_name": "Updated Creative",
      "advertiser_id": "1234-abcd-qwer-xcvb",
      "status": true,
      "tags": [...],
      "start_flight_date": "2022-12-01",
      "end_flight_date": "2023-01-01",
      "campaigns": [123,124,125],
      "events": [...],
      "companion_ad": {
        "click_through_url": "https://snarkyspizza.com/...",
        "display_asset_filename": "eat-at-snarkys.png"
      }
    }
  }'

​
✅ Response Example

{
  "Creative": 9999,
  "s3_displayad": { ... }
}

​
🌐 HTTP Request

PATCH /v2/companies/:companyUUID/creatives/:creativeId

​
🧾 Body Parameters

ParameterRequiredTypeDescription
creative_name❌stringNew creative name.
status❌booleanActive or inactive status.
start_flight_date❌stringStart date (Y-M-D).
end_flight_date❌stringEnd date (Y-M-D).
events❌arrayPixel events to attach.
tags❌arrayCategorization tags.
companion_ad❌objectDisplay ad object.
campaigns❌arrayAssociated campaign IDs.
advertiser_id❌stringUUID of the advertiser.