• release-5.28.0 (#35)latest3,7993584,122Docs25031472026-06-04 18:44

  Change detail

  8,279 changes across 249 operations and 182 models

  AllBreakingWarningInfo

  • POST/catalogs/feeds
    • breaking

      added CatalogsFeedProcessingScheduleTimezone to the oneOf[subschema #1: feeds_create_request]/oneOf[subschema #1: feeds_retail_create_request]/preferred_processing_schedule/timezone request property allOf list

    • breaking

      added CatalogsFeedProcessingScheduleTimezone to the oneOf[subschema #1: feeds_create_request]/oneOf[subschema #2: feeds_hotel_create_request]/preferred_processing_schedule/timezone request property allOf list

    • breaking

      added CatalogsFeedProcessingScheduleTimezone to the oneOf[subschema #1: feeds_create_request]/oneOf[subschema #3: feeds_creative_assets_create_request]/preferred_processing_schedule/timezone request property allOf list

    • breaking

      added CatalogsFeedProcessingScheduleTimezone to the oneOf[subschema #2: legacy_retail_only]/preferred_processing_schedule/timezone request property allOf list

    • breaking

      the request property oneOf[subschema #1: feeds_create_request]/oneOf[subschema #1: feeds_retail_create_request]/preferred_processing_schedule/timezone became not nullable

    • breaking

      the request property oneOf[subschema #1: feeds_create_request]/oneOf[subschema #2: feeds_hotel_create_request]/preferred_processing_schedule/timezone became not nullable

    • breaking

      the request property oneOf[subschema #1: feeds_create_request]/oneOf[subschema #3: feeds_creative_assets_create_request]/preferred_processing_schedule/timezone became not nullable

  View all changes (8,279)
• release-5.23.0 (#33)18736Docsc05b1892025-12-11 22:36

  Change detail

  61 changes across 18 operations and 3 models

  AllBreakingWarningInfo

  • POST/ad_accounts/{ad_account_id}/bulk/upsert
    • breaking

      the request property update/labels/items/status became not nullable

    • breaking

      removed the enum value ACTIVE of the request property update/labels/items/status

    • breaking

      removed the enum value undefined of the request property update/labels/items/status

    • info

      added the new optional request property create/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_type

    • info

      added the new optional request property create/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_url

    • info

      added the new optional request property update/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_type

    • info

      added the new optional request property update/ads/items/allOf[#/components/schemas/AdCommon]/disclosure_url

  View all changes (61)
• release-5.22.0 (#32)88866340Docs568e8a02025-12-11 21:47

  Change detail

  1,294 changes across 35 operations and 1 model

  AllBreakingWarningInfo

  • PATCH/ad_accounts/{ad_account_id}/audiences/{audience_id}
    • breaking

      request body became required

    • breaking

      added Currency to the allOf[subschema #1: AudienceCommon]/rule/event_data/currency request property allOf list

    • breaking

      added LineItem to the allOf[subschema #1: AudienceCommon]/rule/event_data/line_items request property allOf list

    • breaking

      removed the enum value ARS of the request property allOf[subschema #1: AudienceCommon]/rule/event_data/currency

    • breaking

      removed the enum value AUD of the request property allOf[subschema #1: AudienceCommon]/rule/event_data/currency

    • breaking

      removed the enum value BRL of the request property allOf[subschema #1: AudienceCommon]/rule/event_data/currency

    • breaking

      removed the enum value CAD of the request property allOf[subschema #1: AudienceCommon]/rule/event_data/currency

  View all changes (1,294)
• release-5.21.0 (#31)5866Docsb7bc1952025-12-10 07:08

  Change detail

  79 changes across 13 operations and 2 models

  AllBreakingWarningInfo

  • POST/ad_accounts/{ad_account_id}/events
    • breaking

      the request property data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em became required

    • breaking

      the request property data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em became required

    • info

      the request property data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids became optional

    • info

      the request property data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address became optional

    • info

      the request property data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent became optional

  • POST/ad_accounts
    • breaking

      the owner response's property type changed from object to no type for status 200

    • warning

      removed the optional property owner/id from the response with the 200 status

  View all changes (79)
• release-5.20.0 (#29)64205254Docs1b47c642025-10-16 18:40

  Change detail

  523 changes across 60 operations and 7 models

  AllBreakingWarningInfo

  • POST/ad_accounts/{ad_account_id}/ad_previews
    • breaking

      added CustomizableCTAType subschema #2 to the oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type request property allOf list

    • breaking

      the request property oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type became not nullable

    • breaking

      removed the enum value BOOK_NOW of the request property oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type

    • breaking

      removed the enum value GET_DEAL of the request property oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type

    • breaking

      removed the enum value ON_SALE of the request property oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type

    • breaking

      removed the enum value SHOP_NOW of the request property oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type

    • breaking

      removed the enum value undefined of the request property oneOf[subschema #3: AdPreviewShopping]/customizable_cta_type

  View all changes (523)
• release-5.18.0 (#27)78724157Docseb55b252025-08-14 16:00
• release-5.17.0 (#26)5537Docse7884cd2025-08-12 20:25
• release-5.16.0 (#24)261,227934Docsdfb89fd2025-07-16 21:09
• release v5.15.0 (#20) (#22)223,2461,241Docs57cb6b22025-04-04 22:30
• v5.14.0 release (#20)622292276Docs774983b2024-08-14 18:42
• release v5.13.0 (#19)95164128Docs7e8864d2024-04-23 19:23
• release v5.12.0 (#18)54105291Docs1dfb7f52024-02-08 23:48
• Release version 5.11.0 (#17)179459Docsf02d9d22023-08-17 17:58
• release-5.10.0 (#16)4094386Docsc9d94012023-07-14 18:33
• release-5.9.0 (#15)5933540Docsc9cf0522023-05-12 16:58
• Release 5.8.0 (#14)13136167Docs0a648f12023-02-14 18:08
• Release 5.6.0 (#11)523199Docs39675c62022-11-14 18:22
• Release 5.5.0 (#10)27106136Docs0ab3a022022-09-07 18:44
• Release 5.4.1 (#9)1Docs6f617262022-07-12 00:11
• Release 5.4.0 (#8)16109195Docs72349772022-07-11 18:11
• updating spec to reflect changes with 5.3.0 version (#7)21494Docs27760bd2022-04-12 22:23
• reverting changes, meant to commit previous change for review692214Docsc9258972022-04-08 23:39
• updating api descriptions to reflect minor version upgrade10226Docs86c544b2022-04-08 23:33
• Release 5.1.2 (#5)312Docsbf2fe592022-02-09 23:32
• Release 5.1.1 (#3)5Docs5079c522022-01-19 17:53
• Release 5.1.0 (#2)2Docseaf2e132022-01-07 20:31
• Release 5.0.2 (#1)103Docsd56e0b22021-12-16 21:55
• Version 5.0.136156Docs25ab1eb2021-11-05 22:51
• Initial public releaseDocs40b09792021-04-16 18:06

Revisions go back to the API's first capture.