TestFlight installation blocked; external review fails with HTTP 422 BETA_CONTRACT_MISSING

SUMMARY

TestFlight installation and external beta review submission are blocked for ITNRY. External submission returns ENTITY_UNPROCESSABLE.BETA_CONTRACT_MISSING through both the App Store Connect website and the public App Store Connect API.

Apple Developer Support case: 102968975728 Submitted: 19 September 2026 I have not yet received a response.

APP AND BUILD DETAILS

App: ITNRY: Private Trip Planner App Store Connect app ID: 6747810116 Bundle ID: com.c0defr1ft.ITNRY

Version 5.5, build 1:

  • Build ID: ace0e146-a828-49cd-8773-351f12dfc4b0
  • buildAudienceType: APP_STORE_ELIGIBLE
  • processingState: VALID
  • expired: false

Version 5.5, build 2:

  • Build ID: 4cb01458-8df0-44f5-810c-5a9769a2980d
  • buildAudienceType: INTERNAL_ONLY
  • processingState: VALID
  • expired: false

The external review submission described below uses build 1, NOT the internal-only build 2.

STEPS TO REPRODUCE — APP STORE CONNECT

  1. Open ITNRY → TestFlight.
  2. Add version 5.5, build 1 to an external testing group.
  3. Complete the requested test information.
  4. Select Submit for Review.

Actual result: “There was an error processing your request. Please try again later.”

The failed network response contains: HTTP 422 ENTITY_UNPROCESSABLE.BETA_CONTRACT_MISSING “Beta contract is missing for the app.”

STEPS TO REPRODUCE — PUBLIC API

Send an authenticated request to:

POST https://api.appstoreconnect.apple.com/v1/betaAppReviewSubmissions

Request body:

{ "data": { "type": "betaAppReviewSubmissions", "relationships": { "build": { "data": { "type": "builds", "id": "ace0e146-a828-49cd-8773-351f12dfc4b0" } } } } }

Actual response:

HTTP 422

{ "errors": [ { "id": "d916bbd9-4cff-4a05-8f0c-7432ec8db5d3", "status": "422", "code": "ENTITY_UNPROCESSABLE.BETA_CONTRACT_MISSING", "title": "Beta contract is missing for the app.", "detail": "Beta Contract is missing." } ] }

Request ID: EYMVAZWCULILULIFKLQDUQ5DXI Timestamp: 19 September 2026, 17:32:43 UTC

ADDITIONAL SYMPTOM — INTERNAL TESTFLIGHT

The build is visible in TestFlight, but installation fails with: “The requested app is not available or doesn’t exist.”

The iPhone’s Media & Purchases account matches the account assigned as an internal tester. TestFlight has also displayed an old email address previously associated with the same Apple Account. It is unclear whether this is related to the contract error.

DIAGNOSTIC CHECKS ALREADY COMPLETED

GET /v1/apps/6747810116/betaLicenseAgreement returns HTTP 200 and the following betaLicenseAgreements resource:

8289bafa-8347-4a7a-a2b4-86b580758220

Listing betaLicenseAgreements filtered by this app also returns that resource.

Its agreementText was initially empty. As a troubleshooting attempt, I successfully populated it through the API and verified that the change persisted. External submission still returned the identical BETA_CONTRACT_MISSING error afterward.

This establishes that the per-app betaLicenseAgreement resource exists. It does not establish whether that resource is the contract referenced by the submission error.

EXPECTED RESULT

An authorized internal tester should be able to install the assigned build. An eligible external build should submit for beta review, or App Store Connect should identify a specific outstanding requirement and provide an actionable way to resolve it.

IMPACT AND REQUEST

The issue blocks TestFlight installation and external beta review submission.

Please investigate the contract validation/provisioning state for this app/account, identify which contract is reported missing, and advise whether any developer action is required. Please also determine whether the internal installation failure shares the same cause.

Please link this report to Developer Support case 102968975728.

Forgot to add FB ref: FB24932119

TestFlight installation blocked; external review fails with HTTP 422 BETA_CONTRACT_MISSING
 
 
Q