---
title: "Changes to POST /v1/promotions/{id}/ads"
method: POST
path: "/v1/promotions/{id}/ads"
---

# Changes to POST /v1/promotions/{id}/ads

`POST /v1/promotions/{id}/ads`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 8 revisions.

- **2026-08-29** `6b7ccc7e2651` — 210 info
- **2026-08-22** `10ee593749b3` — 259 info
- **2026-08-17** `1c8b6833fbae` — 259 info

## Changes

- **2026-08-29** `6b7ccc7e2651` — 210 info
  - added the new optional request property `carouselAds/items/slides/items/videos/items/audioCodec`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/bitrateBps`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/compressedVideoUrl`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/duration`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/hasAudio`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/justOptimized`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/metadataStatus`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/originalSize`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/originalUrl`
  - added the new optional request property `carouselAds/items/slides/items/videos/items/videoCodec`
  - added the new optional request property `carouselAds/items/verticalVideos/items/audioCodec`
  - added the new optional request property `carouselAds/items/verticalVideos/items/bitrateBps`
  - added the new optional request property `carouselAds/items/verticalVideos/items/compressedVideoUrl`
  - added the new optional request property `carouselAds/items/verticalVideos/items/duration`
  - added the new optional request property `carouselAds/items/verticalVideos/items/hasAudio`
  - added the new optional request property `carouselAds/items/verticalVideos/items/justOptimized`
  - added the new optional request property `carouselAds/items/verticalVideos/items/metadataStatus`
  - added the new optional request property `carouselAds/items/verticalVideos/items/originalSize`
  - added the new optional request property `carouselAds/items/verticalVideos/items/originalUrl`
  - added the new optional request property `carouselAds/items/verticalVideos/items/videoCodec`
  - added the new optional request property `carouselAds/items/videos/items/audioCodec`
  - added the new optional request property `carouselAds/items/videos/items/bitrateBps`
  - added the new optional request property `carouselAds/items/videos/items/compressedVideoUrl`
  - added the new optional request property `carouselAds/items/videos/items/duration`
  - added the new optional request property `carouselAds/items/videos/items/hasAudio`
  - added the new optional request property `carouselAds/items/videos/items/justOptimized`
  - added the new optional request property `carouselAds/items/videos/items/metadataStatus`
  - added the new optional request property `carouselAds/items/videos/items/originalSize`
  - added the new optional request property `carouselAds/items/videos/items/originalUrl`
  - added the new optional request property `carouselAds/items/videos/items/videoCodec`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/audioCodec`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/bitrateBps`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/compressedVideoUrl`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/duration`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/hasAudio`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/justOptimized`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/metadataStatus`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/originalSize`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/originalUrl`
  - added the new optional request property `collectionAds/items/slides/items/videos/items/videoCodec`
  - …170 more
- **2026-08-22** `10ee593749b3` — 259 info
  - added the new `YEXT` enum value to the request property `carouselAds/items/channels/items/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/googleUserLists/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/googleUserLists/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/googleUserLists/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/googleUserLists/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/linkedInMatchedAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/linkedInMatchedAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/pinterestAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/pinterestAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/tikTokAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/tikTokAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/twitterCustomAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/twitterCustomAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/googleUserLists/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/googleUserLists/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/engagementSource`
  - added the new `YEXT` enum value to the request property `collectionAds/items/channels/items/channel`
  - added the new `YEXT` enum value to the request property `collectionAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `YEXT` enum value to the request property `collectionAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - …219 more
- **2026-08-17** `1c8b6833fbae` — 259 info
  - added the new `CANTO` enum value to the request property `carouselAds/items/channels/items/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/googleUserLists/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/googleUserLists/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/facebookAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/googleUserLists/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/googleUserLists/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/linkedInMatchedAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/linkedInMatchedAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/pinterestAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/pinterestAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/tikTokAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/tikTokAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/twitterCustomAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/adGroupExclusion/retargeting/twitterCustomAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/googleUserLists/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/googleUserLists/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/linkedInMatchedAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/pinterestAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/tikTokAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `carouselAds/items/googleAdGroups/items/retargeting/twitterCustomAudiences/items/retargetingList/engagementSource`
  - added the new `CANTO` enum value to the request property `collectionAds/items/channels/items/channel`
  - added the new `CANTO` enum value to the request property `collectionAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/channel`
  - added the new `CANTO` enum value to the request property `collectionAds/items/facebookAdGroups/items/retargeting/facebookCustomAudiences/items/retargetingList/engagementSource`
  - …219 more

---

[Operation](https://skmtc.dev/adhook/apis/adhook-io-api/docs/v1/promotions/:id/ads/post.md) · [API](https://skmtc.dev/adhook/apis/adhook-io-api.md) · [Page](https://skmtc.dev/adhook/apis/adhook-io-api/changes/v1/promotions/:id/ads/post)