---
title: Add an Alternative Distribution Key
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v1-alternativedistributionkeys
---

# Add an Alternative Distribution Key

Add an alternative distribution key for your alternative marketplace app or web distribution.

## URL

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

## Response Codes

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

## Mentioned in

Creating and configuring keys for web distribution Creating keys and establishing alternative marketplace connections Configuring alternative marketplaces and alternative marketplace apps

## Discussion

Discussion You can use a single alternative distribution key for all alternative distribution apps on your account. You can optionally use an app specific alternative distribution key, by adding a relationship to a specific app in the JSON payload used with this endpoint. Example Request and Response Example Request and Response

## See Also

### Creating and reading keys

- [Creating keys and establishing alternative marketplace connections](appstoreconnectapi/creating-keys-and-establishing-alternative-marketplace-connections.md)
- [Creating and configuring keys for web distribution](appstoreconnectapi/creating-and-configuring-keys-for-web-distribution.md)
- [List Alternative Distribution Keys](appstoreconnectapi/get-v1-alternativedistributionkeys.md)
- [Read Alternative Distribution Key Information](appstoreconnectapi/get-v1-alternativedistributionkeys-_id_.md)
- [Get the alternative distribution key ID for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-alternativedistributionkey.md)
- [Read an App’s Alternative Distribution Key](appstoreconnectapi/get-v1-apps-_id_-alternativedistributionkey.md)
- [Remove an Alternative Distribution Key](appstoreconnectapi/delete-v1-alternativedistributionkeys-_id_.md)