App Store Connect Help

Support / App Store Connect / Manage your team / Manage webhooks

Manage your team

Manage webhooks

You can optionally define a webhook URL in App Store Connect to receive automatic notifications to your web server when there are updates or changes to an app, such as:

To receive these notifications, implement an endpoint on your web server, or webhook. Learn more about the event triggers and how to process them.

A webhook can only apply to one app, and you can create up to ten webhooks per app.

Learn how to manage webhooks using the App Store Connect API.

Required role: Account Holder, Admin, or App Manager. View role permissions.

Create a webhook

  1. In Users and Access, click Integrations.

  2. Under Additional, click Webhooks.

  3. Next to Webhooks, click the add button (+).

  4. Screenshot of the Users and Access section which displays a table with columns for Name, Payload URL, Event Types, and App. Two webhooks are listed: App Statuses linked to Exercise App and New Screenshot Feedback linked to Backyard Birds. A plus button is visible to add new webhooks.
  5. Enter a Name for your webhook.

  6. Screenshot of a form that includes fields labeled Name with a dropdown menu, Payload URL, and Event Types, alongside a circular icon featuring a plus sign indicating the action to create or add a new webhook.
  7. Enter the Payload URL. This is the URL where you want to receive notifications.

  8. Enter a Secret. The string of text you define here is used by your server to verify that a webhook delivery is from App Store Connect and authentic.

  9. Select the app you want to receive notifications for.

  10. Select at least one event trigger that you want to receive notifications for.

  11. Click Add.

Test webhook delivery

  1. In Users and Access, click Integrations.

  2. Under Additional, click Webhooks.

  3. In the table on the right, click the webhook you want to test.

  4. In the top right corner of the page, click Test.

  5. A test webhook delivery will be sent to your server. It will appear under the Recent Deliveries table with the Ping event trigger.

Manage webhook details

You can edit the name, secret, payload URL, and event triggers associated with a webhook at any time. You can’t change the app associated with an existing webhook. Instead, you must create a new webhook for that app.

  1. In Users and Access, click Integrations.

  2. Under Additional, click Webhooks.

  3. In the table on the right, click the webhook you want to modify.

  4. Make your desired changes, then click Save.

  5. Changes will go into effect immediately.

Turn off a webhook

Turn off a webhook to temporarily stop notifications from being delivered. When you’re ready, follow the same steps to turn it on again.

  1. In Users and Access, click Integrations.

  2. Under Additional, click Webhooks.

  3. In the table on the right, click the webhook you want to modify.

  4. Click Turn Off Webhook. If you're re-enabling a webhook, click Turn On Webhook.

  5. Click Confirm.

Delete a webhook

Delete a webhook to permanently remove it from App Store Connect. This action cannot be reversed.

  1. In Users and Access, click Integrations.

  2. Under Additional, click Webhooks.

  3. In the table on the right, click the webhook you want to modify.

  4. Click Delete Webhook.

  5. Click Confirm.

View recent webhook deliveries

  1. In Users and Access, click Integrations.

  2. Under Additional, click Webhooks.

  3. In the table on the right, click the webhook you want to view deliveries for.

  4. Below Recent Deliveries, observe the event ID, event type, created date, and status for up to 20 of the most recent deliveries over the last week.

  5. You also have the option to refresh the list of recent deliveries using the refresh icon at the top right of the table.

    The possible webhook delivery statuses are:

    Status

    Description

    Success

    The webhook was successfully delivered to your server.

    Pending

    The webhook is in the process of being delivered to your server.

    Failed

    The webhook failed to deliver to your server. You can resend the delivery to try again.

    Screenshot of webhook details such as Name, Payload URL, App, and Secret. Includes event trigger options and a list of recent deliveries with statuses like Success and Failed.
  6. Click the event ID to view additional details, including the Event ID, Request Payload, and Response Payload (when available).

  7. Screenshot of the sections for Status, Created Date, Event Type, Event ID, Payload URL, Request Payload with JSON data, and Response Payload with HTTP Status Code. The status is Success - Redelivery.

Resend a webhook delivery

You have the option to resend webhook deliveries with the Failed or Success status. Test deliveries can’t be resent.

Resending a webhook delivery will create a new delivery record with the same event ID. After you’ve resent a delivery, you won’t be able to resend it again. However, you can resend the newly created delivery record.

  1. In Users and Access, click Integrations.

  2. Under Additional, click Webhooks.

  3. In the table on the right, click the webhook you want to resend a delivery for.

  4. Below Recent Deliveries, locate the delivery in the Failed status and click Resend.

  5. Screenshot of webhook details such as Name, Payload URL, App association, and Secret. Allows event triggering and webhook management with options to test, save, disable, or delete. Shows recent delivery statuses including pending, success, and failed events.