<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-store-version-promotions",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Store Version Promotions"
}
-->

# App Store Version Promotions

Apply a version experiment treatment to your app’s product page in the App Store, or to your upcoming App Store version.

## Topics

### Endpoints

[`POST /v1/appStoreVersionPromotions`](/documentation/AppStoreConnectAPI/POST-v1-appStoreVersionPromotions)

Promote a specific App Store version.

### Objects

[`AppStoreVersionPromotion`](/documentation/AppStoreConnectAPI/AppStoreVersionPromotion)

A promoted feature badge for an App Store version, highlighting it as new or updated in the App Store.

[`AppStoreVersionPromotionCreateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionPromotionCreateRequest)

The request body you use to create an App Store version promotion.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)