<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/subscription-promotional-offers",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Subscription Promotional Offers"
}
-->

# Subscription Promotional Offers

Create, modify, and delete promotional offers for auto-renewable subscriptions.

## Topics

### Endpoints

[`Create a promotional offer`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionPromotionalOffers)

Create a promotional offer for an auto-renewable subscription.

[`List all promotional offer prices for a subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionPromotionalOffers-_id_-prices)

Get a list of prices of a promotional offer for an auto-renewable subscription, for a specified territory.

[`List price IDs for a subscription promotional offer`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionPromotionalOffers-_id_-relationships-prices)

[`Read promotional offer information`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionPromotionalOffers-_id_)

Get details about a specific promotional offer for an auto-renewable subscription.

[`Modify a promotional offer`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionPromotionalOffers-_id_)

Update the prices for a specific promotional offer for an auto-renewable subscription.

[`Delete a promotional offer from a subscription`](/documentation/AppStoreConnectAPI/DELETE-v1-subscriptionPromotionalOffers-_id_)

Delete a specific promotional offer from an auto-renewable subscription.

### Objects

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

A discounted or free trial offer for an auto-renewable subscription, available to eligible existing or former subscribers.

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

The request body you use to create a subscription promotional offer.

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

An inline object for specifying a promotional offer when creating or updating a subscription.

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

The territory-specific customer price and duration for a subscription promotional offer.

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

An inline object for specifying territory pricing when creating a subscription promotional offer.

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

A response containing a list of territory-specific prices for a subscription promotional offer.

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

The response body for endpoints that create, read, or modify a single subscription promotional offer.

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

The request body you use to update a subscription promotional offer update request.

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

The response body for endpoints that list promotional offers for a subscription.


---

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)