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_store_version_app_version_state_updated
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
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.
build_beta_detail_external_build_state_updated
Learn about the BUILD_BETA_DETAIL_EXTERNAL_BUILD_STATE_UPDATED webhook event. Fired when a TestFlight external beta build is approved, rejected, or expires.
beta_feedback_crash_submission_created
Learn about the BETA_FEEDBACK_CRASH_SUBMISSION_CREATED webhook event. Fired when a TestFlight tester submits a crash report with logs and device details.
beta_feedback_screenshot_submission_created
Learn about the BETA_FEEDBACK_SCREENSHOT_SUBMISSION_CREATED webhook event. Fired when a TestFlight tester submits screenshot feedback.
background_asset_version_state_updated
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_version_app_store_release_state_updated
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_version_external_beta_release_state_updated
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_version_internal_beta_release_created
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
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
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
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_pref
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
Learn about the DID_FAIL_TO_RENEW App Store Server Notification V2. Fired when a subscription renewal fails due to a billing issue.
expired
Learn about the EXPIRED App Store Server Notification V2. Fired when a subscription expires and is no longer active.
grace_period_expired
Learn about the GRACE_PERIOD_EXPIRED App Store Server Notification V2. Fired when the billing grace period ends without successful payment.
offer_redeemed
Learn about the OFFER_REDEEMED App Store Server Notification V2. Fired when a customer redeems a subscription offer code.
price_increase
Learn about the PRICE_INCREASE App Store Server Notification V2. Fired when customer consent is required for a subscription price increase.
refund
Learn about the REFUND App Store Server Notification V2. Fired when Apple refunds an in-app purchase or subscription transaction.
refund_declined
Learn about the REFUND_DECLINED App Store Server Notification V2. Fired when Apple declines a customer refund request.
refund_reversed
Learn about the REFUND_REVERSED App Store Server Notification V2. Fired when Apple reverses a previously granted refund.
revoke
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
Learn about the CONSUMPTION_REQUEST App Store Server Notification V2. Fired when Apple requests consumption data to help process a refund.
test
Learn about the TEST App Store Server Notification V2. A test notification to verify your server endpoint is reachable.
renewal_extended
Learn about the RENEWAL_EXTENDED App Store Server Notification V2. Fired when a subscription renewal date is extended.
external_purchase_token
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