Apple Webhook Events

Learn about the APP_STORE_VERSION_APP_VERSION_STATE_UPDATED webhook event from App Store Connect. Fired when a version is approved, rejected, or moves to another review state.

Learn about the BUILD_UPLOAD_STATE_UPDATED webhook event from App Store Connect. Fired when a build upload finishes processing, fails, or becomes ready for testing.

Learn about the BUILD_BETA_DETAIL_EXTERNAL_BUILD_STATE_UPDATED webhook event. Fired when a TestFlight external beta build is approved, rejected, or expires.

Learn about the BETA_FEEDBACK_CRASH_SUBMISSION_CREATED webhook event. Fired when a TestFlight tester submits a crash report with logs and device details.

Learn about the BETA_FEEDBACK_SCREENSHOT_SUBMISSION_CREATED webhook event. Fired when a TestFlight tester submits screenshot feedback.

Learn about the BACKGROUND_ASSET_VERSION_STATE_UPDATED webhook event. Fired when a background asset version state changes, such as when processing completes.

Learn about the BACKGROUND_ASSET_VERSION_APP_STORE_RELEASE_STATE_UPDATED webhook event. Fired when a background asset App Store release state changes.

Learn about the BACKGROUND_ASSET_VERSION_EXTERNAL_BETA_RELEASE_STATE_UPDATED webhook event. Fired when a background asset external beta release state changes.

Learn about the BACKGROUND_ASSET_VERSION_INTERNAL_BETA_RELEASE_CREATED webhook event. Fired when a background asset version is created for internal beta release.

Learn about the ALTERNATIVE_DISTRIBUTION_PACKAGE_VERSION_CREATED webhook event from App Store Connect. Fired when a new alternative distribution package version is created.

Learn about the ALTERNATIVE_DISTRIBUTION_PACKAGE_AVAILABLE_UPDATED webhook event. Fired when an alternative distribution package becomes available or unavailable.

Learn about the ALTERNATIVE_DISTRIBUTION_TERRITORY_AVAILABILITY_UPDATED webhook event. Fired when alternative distribution territory availability changes.

Learn about the SUBSCRIBED App Store Server Notification V2. Fired when a customer subscribes for the first time or re-subscribes after expiration.

Learn about the DID_RENEW App Store Server Notification V2. Fired when an auto-renewable subscription successfully renews for a new billing period.

Learn about the DID_CHANGE_RENEWAL_STATUS App Store Server Notification V2. Fired when a customer toggles auto-renew on or off.

Learn about the DID_CHANGE_RENEWAL_PREF App Store Server Notification V2. Fired when a customer upgrades or downgrades their subscription plan.

Learn about the DID_FAIL_TO_RENEW App Store Server Notification V2. Fired when a subscription renewal fails due to a billing issue.

Learn about the EXPIRED App Store Server Notification V2. Fired when a subscription expires and is no longer active.

Learn about the GRACE_PERIOD_EXPIRED App Store Server Notification V2. Fired when the billing grace period ends without successful payment.

Learn about the OFFER_REDEEMED App Store Server Notification V2. Fired when a customer redeems a promotional offer, an offer code, or a win-back offer.

Learn about the PRICE_INCREASE App Store Server Notification V2. Fired when customer consent is required for a subscription price increase.

Learn about the REFUND App Store Server Notification V2. Fired when Apple refunds an in-app purchase or subscription transaction.

Learn about the REFUND_DECLINED App Store Server Notification V2. Fired when Apple declines a customer refund request.

Learn about the REFUND_REVERSED App Store Server Notification V2. Fired when Apple reverses a previously granted refund.

Learn about the REVOKE App Store Server Notification V2. Fired when an in-app purchase is revoked, typically due to Family Sharing changes.

Learn about the CONSUMPTION_REQUEST App Store Server Notification V2. Fired when Apple requests consumption data to help process a refund.

Learn about the TEST App Store Server Notification V2. A test notification to verify your server endpoint is reachable.

Learn about the RENEWAL_EXTENDED App Store Server Notification V2. Fired when a subscription renewal date is extended.

Learn about the EXTERNAL_PURCHASE_TOKEN App Store Server Notification V2. Used for apps distributed through alternative distribution in the EU.

Learn about the ONE_TIME_CHARGE App Store Server Notification V2. Fired when a customer purchases a consumable, non-consumable, or non-renewing subscription.

Learn about the RESCIND_CONSENT App Store Server Notification V2. Fired when a parent or guardian withdraws consent for a child's use of your app.

Learn about the RENEWAL_EXTENSION App Store Server Notification V2. Fired when a batch renewal-date extension completes or fails.

Learn about the METADATA_UPDATE App Store Server Notification V2. Fired when you change subscription metadata through the Advanced Commerce API.

Learn about the MIGRATION App Store Server Notification V2. Fired when you migrate a subscription to the Advanced Commerce API.

Learn about the PRICE_CHANGE App Store Server Notification V2. Fired when you change a subscription price through the Advanced Commerce API.