Apple Webhook Events

Complete reference guide to all App Store Connect webhook events and App Store Server Notification V2 events supported by Yeethook.

Yeethook supports 26 Apple webhook event types across two categories: App Store Connect webhooks (operational events like builds and reviews) and App Store Server Notifications V2 (subscription and in-app purchase events). Click any event below to learn when it fires, what data it includes, and how Yeethook enriches it.

App Store Connect Events (9)

Operational events covering builds, reviews, TestFlight feedback, and background assets.

App Version State Updated

App Version

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.

Build Upload State Updated

Builds

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.

External Build State Updated

TestFlight

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

Crash Submission Created

TestFlight

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

Screenshot Submission Created

TestFlight

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

Background Asset State Updated

Background Assets

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

Background Asset App Store Release State Updated

Background Assets

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

Background Asset External Beta Release State Updated

Background Assets

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

Background Asset Internal Beta Release Created

Background Assets

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

App Store Server Notifications V2 (17)

Subscription and in-app purchase lifecycle events covering renewals, refunds, cancellations, and more.

Subscribed

Subscriptions

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

Did Renew

Subscriptions

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

Did Change Renewal Status

Subscriptions

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

Did Change Renewal Preference

Subscriptions

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

Did Fail to Renew

Subscriptions

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

Expired

Subscriptions

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

Grace Period Expired

Subscriptions

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

Offer Redeemed

Offers

Learn about the OFFER_REDEEMED App Store Server Notification V2. Fired when a customer redeems a subscription offer code.

Price Increase

Offers

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

Refund

Refunds

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

Refund Declined

Refunds

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

Refund Reversed

Refunds

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

Revoke

Revocations

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

Consumption Request

Other

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

Test

Other

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

Renewal Extended

Other

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

External Purchase Token

Other

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

Get all events in Slack

Connect Yeethook to receive all 26 event types in your Slack channels. Enrichment included with a p8 key.

Get Started Free