<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/notifications",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Notifications"
}
-->

# Notifications

Add and read information for alternative distribution package notifications.

## Discussion

Alternative marketplaces can use the marketplace webhooks API [`Add a Marketplace Webhook Configuration`](/documentation/AppStoreConnectAPI/POST-v1-marketplaceWebhooks) endpoint to set up an `endpointURL,` where the marketplace receives notifications about changes to apps that it distributes.

The most typical notifications are:

- A new app version is available.
- A specific app version needs to be removed.
- All versions of an app need to be removed.

To learn more about configuring a webhook URL using the API, see [`Add a Marketplace Webhook Configuration`](/documentation/AppStoreConnectAPI/POST-v1-marketplaceWebhooks).

To learn more about server-side processing of marketplace webhook notifications, see <doc://com.apple.documentation/documentation/marketplacekit/processing-alternative-marketplace-notifications>.

> Note:
> To receive notifications for an app, the developer of an app distributed on an alternative marketplace must enable it in App Store Connect, to learn more see [Manage distribution on an alternative app marketplace](https://developer.apple.com/help/app-store-connect/distributing-apps-in-the-european-union/manage-distribution-on-an-alternative-app-marketplace). If a developer doesn’t opt-in to notifications, they must provide that alternative distribution ID to the marketplace so the marketplace can ingest the alternative distribution package. To learn more about server-side processing of marketplace webhooks, see <doc://com.apple.documentation/documentation/marketplacekit/processing-alternative-marketplace-notifications>.

## Topics

### Managing Webhook Endpoint URLs

[`Read Marketplace Webhook Information`](/documentation/AppStoreConnectAPI/GET-v1-marketplaceWebhooks)

Get the endpoint URL for alternative distribution package notifications.

[`Add a Marketplace Webhook Configuration`](/documentation/AppStoreConnectAPI/POST-v1-marketplaceWebhooks)

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

[`Modify a Marketplace Webhook Configuration`](/documentation/AppStoreConnectAPI/PATCH-v1-marketplaceWebhooks-_id_)

Update the endpoint URL and secret for alternative distribution package notifications.

[`Delete a Marketplace Webhook Configuration`](/documentation/AppStoreConnectAPI/DELETE-v1-marketplaceWebhooks-_id_)

Delete a specific marketplace notifcation endpoint URL.

### Objects

[`MarketplaceWebhook`](/documentation/AppStoreConnectAPI/MarketplaceWebhook)

A webhook endpoint that receives event notifications from an alternative marketplace, such as app availability changes.

[`MarketplaceWebhookCreateRequest`](/documentation/AppStoreConnectAPI/MarketplaceWebhookCreateRequest)

The request body you use to create a marketplace webhook url.

[`MarketplaceWebhookResponse`](/documentation/AppStoreConnectAPI/MarketplaceWebhookResponse)

A response containing a single marketplace webhook endpoint configuration.

[`MarketplaceWebhooksResponse`](/documentation/AppStoreConnectAPI/MarketplaceWebhooksResponse)

A response containing a list of webhook endpoints for an alternative marketplace.

[`MarketplaceWebhookUpdateRequest`](/documentation/AppStoreConnectAPI/MarketplaceWebhookUpdateRequest)

The request body you use to update a marketplace webhook url.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)