---
title: Promote a purchase
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v1-promotedpurchases
---

# Promote a purchase

Add an existing in-app purchase or auto-renewable subscription to the promoted in-app purchases on an app listing in the App Store.

## URL

POST https://api.appstoreconnect.apple.com/v1/promotedPurchases

## Response Codes

201 Created: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 409 Conflict: 422 : 429 :

## Mentioned in

Managing auto-renewable subscriptions Managing in-app purchases

## See Also

### Endpoints

- [List all promoted purchases for an app](appstoreconnectapi/get-v1-apps-_id_-promotedpurchases.md)
- [List promoted purchase ids for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-promotedpurchases.md)
- [Read promoted purchase information](appstoreconnectapi/get-v1-promotedpurchases-_id_.md)
- [Modify a promoted in-app purchase](appstoreconnectapi/patch-v1-promotedpurchases-_id_.md)
- [Modify the order of a promoted purchase for an app](appstoreconnectapi/patch-v1-apps-_id_-relationships-promotedpurchases.md)
- [Remove a promoted purchase](appstoreconnectapi/delete-v1-promotedpurchases-_id_.md)