The APP_STORE_VERSION_APP_VERSION_STATE_UPDATED event fires whenever an App Store version changes state during the review and release process. This is one of the most important events for iOS teams because it tells you exactly where your app stands in Apple's review pipeline.
When does it fire?
This event triggers on every state transition for an App Store version, including:
- Waiting for Review — your build has been submitted and is queued
- In Review — Apple is actively reviewing your app
- Approved / Ready for Distribution — your app passed review
- Rejected — Apple found issues that need to be addressed
- Developer Rejected — you pulled the submission yourself
- Pending Developer Release — approved and waiting for you to release
Each transition sends a separate webhook event, so you can track the full lifecycle from submission to release.
Payload highlights
The webhook payload includes the app ID, the version string (e.g. "2.1.0"), the build number, the previous state, and the new state. This lets you build Slack alerts that say exactly what changed, such as "MyApp 2.1.0 moved from In Review to Approved."
How Yeethook helps
Without Yeethook, you need to poll the App Store Connect API or manually check the dashboard. With Yeethook, every state change arrives in Slack within seconds. If you provide a p8 key, Yeethook adds the version description, review notes, and release date to the Slack message.
Common use cases
- Get instant alerts when your app is approved or rejected
- Track how long each review takes by comparing timestamps
- Notify your release manager when a version is ready for distribution
- Trigger CI/CD pipelines on approval