Contents

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

StatusReasonTypeDescription
201Created
Content-Type: application/json
MarketplaceWebhookResponse

400Bad Request
Content-Type: application/json
ErrorResponse

401Unauthorized
Content-Type: application/json
ErrorResponse

403Forbidden
Content-Type: application/json
ErrorResponse

409Conflict
Content-Type: application/json
ErrorResponse

422
Content-Type: application/json
ErrorResponse

429
Content-Type: application/json
ErrorResponse

Mentioned in

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

HTTP Body

See Also

Managing Webhook Endpoint URLs