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

# Webhook notifications

Manage notifications from App Store about your apps and their statuses.

## Discussion

Webhooks enable a system to send real-time data to another system over the web. Unlike traditional APIs, where one system must make a request when receiving data, a webhook enables you to push data to the receiving system as soon as an event occurs. Webhooks are *event-driven*, meaning they are triggered by a specific action or event and immediately send the relevant data to a predefined URL, also called the “webhook URL” or “callback URL”.

A notification webhook is an endpoint you create on your server. This webhook endpoint receives `HTTP POST` requests from App Store Connect. The `POST` requests describe important events about your app. Use the webhooks notifications endpoint to configure the notifications for events happening to your apps.

To invoke your webhook, App Store Connect needs to know your server’s webhook endpoint URL. To set up your webhook endpoint the first time, provide the URL to the [`Create a Webhook Configuration`](/documentation/AppStoreConnectAPI/POST-v1-webhooks) endpoint.

To learn more about:

- Configuring a webhook URL using the API, see [Configuring and parsing App Store Connect API webhook notifications](/documentation/AppStoreConnectAPI/configuring-webhook-notifications).
- Events that can trigger a webhook notification, see [Understanding webhook events](/documentation/AppStoreConnectAPI/webhook-events) and [`WebhookEventType`](/documentation/AppStoreConnectAPI/WebhookEventType).

## Topics

### Essentials

[Configuring and parsing App Store Connect API webhook notifications](/documentation/AppStoreConnectAPI/configuring-webhook-notifications)

Manage the configuration, testing, and processing of App Store Connect API notifications for your app.

[Understanding webhook events](/documentation/AppStoreConnectAPI/webhook-events)

Learn the events that describe payloads and the notifications the system sends.

### Managing webhook notifications

[`Read Webhook Information for an App`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-webhooks)

Read webhook configuration details for a specific app.

[`Read Webhook Information`](/documentation/AppStoreConnectAPI/GET-v1-webhooks-_id_)

Read configuration details for a specific webhook.

[`Create a Webhook Configuration`](/documentation/AppStoreConnectAPI/POST-v1-webhooks)

Add a new webhook configuration.

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

Update details for a specific webhook.

[`Delete a Webhook`](/documentation/AppStoreConnectAPI/DELETE-v1-webhooks-_id_)

Remove a specific webhook configuration.

### Managing webhook deliveries

[`Read the Deliveries for a Webhook`](/documentation/AppStoreConnectAPI/GET-v1-webhooks-_id_-deliveries)

Get a list of deliveries for a specific webhook configuration.

[`List delivery IDs for a webhook`](/documentation/AppStoreConnectAPI/GET-v1-webhooks-_id_-relationships-deliveries)

[`Redeliver a Previous Notification`](/documentation/AppStoreConnectAPI/POST-v1-webhookDeliveries)

Resend a webhook notification from a specified template.

### Testing webhook configuration

[`Test Your Webhook`](/documentation/AppStoreConnectAPI/POST-v1-webhookPings)

Send an event to your server to verify your server-side webhook configuration.

### Objects and types

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

A configured HTTP endpoint in App Store Connect that receives notifications when specific events occur.

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

The request body for registering a webhook endpoint to receive App Store Connect event notifications.

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

A response containing a list of webhook delivery records, each showing the outcome of a notification attempt.

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

A recorded delivery attempt of an event notification to a webhook endpoint, including the request and response details.

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

The request body for retrying a failed webhook delivery.

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

A response containing a single webhook delivery attempt record.

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

An event type that can trigger webhook notifications, such as build completion or review status changes.

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

A test payload sent to verify that a webhook endpoint is reachable and correctly configured.

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

The request body for sending a test ping event to verify that a webhook endpoint is reachable.

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

A response confirming that a test ping was sent to a webhook endpoint.

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

The response body for endpoints that create, read, or modify a single webhook.

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

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

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

The response body for endpoints that list webhooks.

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

A string that represents the the event types for a webhook notification.

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

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



---

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)