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

# Create a subscription version

Create a draft version of an auto-renewable subscription, capturing its current localized metadata and review images for App Review submission.

## URL

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

## 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 version information](appstoreconnectapi/get-v1-subscriptionversions-_id_.md)
- [Read the image for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-image.md)
- [List images for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-images.md)
- [List localizations for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-localizations.md)
- [Read the image ID for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-relationships-image.md)
- [List image IDs for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-relationships-images.md)
- [List localization IDs for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-relationships-localizations.md)
- [List versions for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-versions.md)
- [List version IDs for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-versions.md)