---
title: Create an app store experiment
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v2-appstoreversionexperiments
---

# Create an app store experiment

Add a new experiment to an App Store version.

## URL

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

## Response Codes

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

## Mentioned in

App Store Connect API 2.4 release notes

## Discussion

Discussion Example Request and Response Example Request and Response

## See Also

### Managing App Store version experiments

- [List all experiments for an app store version v1](appstoreconnectapi/get-v1-appstoreversions-_id_-appstoreversionexperiments.md)
- [List all experiments ids for an app store version v1](appstoreconnectapi/get-v1-appstoreversions-_id_-relationships-appstoreversionexperiments.md)
- [List all experiments for an app store version](appstoreconnectapi/get-v1-appstoreversions-_id_-appstoreversionexperimentsv2.md)
- [List all experiment ids for an app store version](appstoreconnectapi/get-v1-appstoreversions-_id_-relationships-appstoreversionexperimentsv2.md)
- [Read app store experiment information](appstoreconnectapi/get-v2-appstoreversionexperiments-_id_.md)
- [List all treatments for an app store experiment](appstoreconnectapi/get-v2-appstoreversionexperiments-_id_-appstoreversionexperimenttreatments.md)
- [List treatment IDs for an app store version experiment](appstoreconnectapi/get-v2-appstoreversionexperiments-_id_-relationships-appstoreversionexperimenttreatments.md)
- [Modify an app store experiment](appstoreconnectapi/patch-v2-appstoreversionexperiments-_id_.md)
- [Delete an app store experiment](appstoreconnectapi/delete-v2-appstoreversionexperiments-_id_.md)
- [Read app store experiment information v1](appstoreconnectapi/get-v1-appstoreversionexperiments-_id_.md)
- [List all treatments for an app store experiment v1](appstoreconnectapi/get-v1-appstoreversionexperiments-_id_-appstoreversionexperimenttreatments.md)
- [List treatment IDs for an App Store version experiment](appstoreconnectapi/get-v1-appstoreversionexperiments-_id_-relationships-appstoreversionexperimenttreatments.md)
- [Modify an app store experiment v1](appstoreconnectapi/patch-v1-appstoreversionexperiments-_id_.md)
- [Create an app store experiment v1](appstoreconnectapi/post-v1-appstoreversionexperiments.md)
- [Delete an app store version experiment v1](appstoreconnectapi/delete-v1-appstoreversionexperiments-_id_.md)