---
title: Add a Marketplace Webhook Configuration
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v1-marketplacewebhooks
---

# Add a Marketplace Webhook Configuration

Add a new endpoint URL and secret for alternative distribution package notifications.

## URL

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

## Response Codes

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

## Mentioned in

App Store Connect API 3.3 release notes Configuring alternative marketplaces and alternative marketplace apps Creating alternative distribution packages

## Discussion

Discussion Each developer account has a single marketplace webhooks endpointUrl, so if you operate mutliple marketplaces all notifications come to a single endpoint. The notification payload contains the marketplaceAppId. Example Request and Response

## See Also

### Managing Webhook Endpoint URLs

- [Read Marketplace Webhook Information](appstoreconnectapi/get-v1-marketplacewebhooks.md)
- [Modify a Marketplace Webhook Configuration](appstoreconnectapi/patch-v1-marketplacewebhooks-_id_.md)
- [Delete a Marketplace Webhook Configuration](appstoreconnectapi/delete-v1-marketplacewebhooks-_id_.md)