---
title: Create an app store version
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v1-appstoreversions
---

# Create an app store version

Add a new App Store version or platform to an app.

## URL

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

## Response Codes

201 Created: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 409 Conflict: The provided resource data is not valid. 422 : 429 :

## Discussion

Discussion Use this endpoint to add a new version of an app. The new version can be an incremental update of an existing app for a particular platform, or it can be the first version on a new platform for the app. Add a New Version of an iOS App

## See Also

### Creating and Modifying App Store Versions

- [Modify an app store version](appstoreconnectapi/patch-v1-appstoreversions-_id_.md)
- [Delete an app store version](appstoreconnectapi/delete-v1-appstoreversions-_id_.md)