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.

App Store ConnectTestFlight
BUILD_BETA_DETAIL_EXTERNAL_BUILD_STATE_UPDATED

The BUILD_BETA_DETAIL_EXTERNAL_BUILD_STATE_UPDATED event fires when the state of a TestFlight external beta build changes. External beta builds require Apple's review before they can be distributed to external testers, and this event tracks that process.


When does it fire?


This event triggers on external beta build state transitions:


  • Waiting for Beta Review — the build is queued for Apple's TestFlight review
  • In Beta Review — Apple is reviewing the build
  • Approved — the build passed review and can be distributed to external testers
  • Rejected — the build was rejected (requires changes before resubmission)
  • Expired — the build's 90-day testing window has elapsed

Payload highlights


The payload includes the app ID, build number, version string, the external build state, and the date of the state change. This lets you track exactly when builds become available for external testing.


How Yeethook helps


TestFlight beta review is typically faster than App Store review, but it can still take hours. Yeethook sends a Slack notification the moment your build is approved for external testing, so you can start distributing to testers immediately.


Common use cases


  • Notify your QA team when a build is approved for external TestFlight testing
  • Catch beta review rejections early so you can fix and resubmit
  • Track build expiration dates to avoid gaps in testing availability
  • Coordinate beta release cycles with your external tester community

Enrichment with p8 key

With a p8 key, Yeethook enriches this event with the full beta build details, tester count, and external tester groups from the App Store Connect API.

Related Events

Get this event in Slack

Connect Yeethook to receive External Build State Updated notifications in your Slack channels.

Get Started Free