---
title: Create a subscription image
framework: App Store Connect API
role: symbol
role_heading: Web Service Endpoint
platforms: [app store connect api 4.4.1+]
path: appstoreconnectapi/post-v2-subscriptionimages
---

# Create a subscription image

Reserve a promotion image for an auto-renewable subscription configured with the v2 API and prepare its asset upload.

## URL

POST https://api.appstoreconnect.apple.com/v2/subscriptionImages

## Response Codes

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

## Mentioned in

App Store Connect API 4.4.1 release notes Submitting subscriptions and subscription groups for App Review Working with subscription versions

## See Also

### Endpoints

- [Read subscription image information](appstoreconnectapi/get-v2-subscriptionimages-_id_.md)
- [Modify a subscription image](appstoreconnectapi/patch-v2-subscriptionimages-_id_.md)
- [Delete a subscription image](appstoreconnectapi/delete-v2-subscriptionimages-_id_.md)