How to fix ITMS-90562 Invalid Bundle error during upload
| Company / Service | Apple App Store Connect (iOS app submission portal) |
|---|---|
| Category | Top 50 Global Companies |
| Guide type | Procedure |
| Skill level | Intermediate to advanced |
| Time | 15 - 60 minutes including verification |
If you hit How to fix ITMS-90562 Invalid Bundle error during upload on Apple App Store Connect (iOS app submission portal) in production, the steps below are the path most backend engineers and SRE on-callers take in 2026. None of them require opening a paid support case unless you are on a Business / Enterprise / Premier plan and want to preserve SLA credits.
What how to fix itms-90562 invalid bundle error during upload actually involves on Apple App Store Connect (iOS app submission portal)
This task on Apple App Store Connect is one of the more searched operational topics across vendor forums and Tom's Hardware in the last 12 months. The procedure below is the path that works on a current Apple App Store Connect setup with default config.
The rest of this page is the structured fix path. Start with diagnose, then remediation, then the automation options so you do not have to do this by hand the next time it surfaces. Verify and safety sections at the end are the discipline that keeps the fix from regressing in production.
Diagnose first, fix second
Start by capturing the exact failure signal in writing before you change a single thing on your Apple App Store Connect (iOS app submission portal) integration. In the browser that is the failing request in DevTools Network tab (right-click, Copy as cURL) plus the JS console error. In the API client that is the response status code (Stripe 402, Twilio 20429, Salesforce INSUFFICIENT_ACCESS_OR_READONLY, Webex 41001, AWS ThrottlingException) and the correlation header (x-request-id, x-amz-request-id, x-ms-correlation-request-id, x-trace-id, X-Salesforce-SFDC-RequestId). On the vendor status page capture the incident ID and timestamp. Screenshot it. Do not paraphrase. Most Apple App Store Connect (iOS app submission portal) support workflows will not even route the ticket without the correlation id - the agent pastes it straight into the internal trace tool and the first response is "we see your request, here is what the backend logged."
Fifth: replay the failing call against the Apple App Store Connect (iOS app submission portal) sandbox or test environment with curl -v (or Postman with the same Authorization header), then capture the full request and response including headers. Pin the API version explicitly: Stripe-Version header (for example 2024-12-18.acacia), Salesforce v60.0 in the URL path, Apple App Store Connect API v1.X, Slack Web API method name, GitHub REST v3 vs GraphQL v4, LinkedIn Marketing API version header. The version pin is what isolates "their rollout broke me" from "my client SDK is old." Use HTTPie for terminal readability (http --print=HhBb POST), or import the cURL into Postman to inspect against the saved environment. If sandbox passes and prod fails with the same payload and the same API version, you have a prod-only data condition (real customer ids, real currency, real geo) and the fix is to capture that exact prod record and rerun against a sandbox tenant seeded from it.
Second pass: open the vendor admin console (Salesforce Setup, Microsoft 365 Admin Center, Google Workspace Admin, AWS Console, Azure Portal, Apple App Store Connect, Google Play Console, Adobe Admin Console, Atlassian admin) and look at the audit log for the failing window on Apple App Store Connect (iOS app submission portal). Salesforce: Setup, Security, View Setup Audit Trail filtered to the last 24 hours. Microsoft 365: Purview Compliance Portal, Audit. Google Workspace: Admin Console, Reporting, Audit and investigation. AWS: CloudTrail Event history filtered by event source. The audit log tells you whether the failure was your code, a config change someone else pushed, or a vendor-side rollout. Many INSUFFICIENT_ACCESS / UNABLE_TO_LOCK_ROW / AD_CLIENT_DISABLED errors trace to a permission or licensing change pushed in the same admin in the previous hour - the audit trail makes that obvious without guesswork.
Solution-focused remediation path
Start by sorting the Apple App Store Connect (iOS app submission portal) failure into one of three buckets, because roughly 80% of cases fall here. Bucket one is auth/config drift: an API key rotated, an OAuth scope dropped, an IAM policy tightened, a tenant moved. Bucket two is SDK or API-version mismatch: client library against deprecated endpoint, Stripe-Version header behind the dashboard default, Salesforce v59 client against a v60 metadata change. Bucket three is rate / quota / billing: Twilio 20429 sustained throughput cap, AWS ThrottlingException at the per-account TPS, Google Ads CAMPAIGN_BUDGET_NOT_ACTIVE, AdSense AD_CLIENT_DISABLED. Pick the bucket first, then act. Before you act, capture a baseline correlation id with curl -v plus the request/response pair so you can prove whether the fix actually moved the needle. Decision point: if the failure is intermittent and you are on a paid Business / Enterprise / Premier plan, open the support portal first - vendor support on an SLA-covered tenant beats hours of speculative debugging on cost and on liability if the failure recurs.
For Apple App Store Connect (iOS app submission portal) integrations where rate limits or quotas are suspect, read the response headers honestly. X-RateLimit-Remaining at zero, Retry-After in seconds, x-ratelimit-reset as a unix timestamp, or a 429 body with a retry hint - each is telling you the exact same thing in a vendor-specific dialect. Twilio 20429 is the per-account messaging throughput cap; AWS ThrottlingException carries a Retry-After header; Salesforce REQUEST_LIMIT_EXCEEDED returns the org daily API call cap; GitHub returns x-ratelimit-remaining: 0 on both the primary and secondary rate limits. Apply exponential backoff with full jitter (base 200ms, cap 30s, retry up to 5 times) and never retry a non-idempotent POST without an idempotency key (Stripe Idempotency-Key header, AWS ClientToken, Atlassian request id). Decision point: if you are hitting the rate limit sustained rather than in bursts, request a quota increase through the vendor admin console (Twilio messaging service throughput request, AWS service quotas, Google Ads account-level limit lift, Salesforce platform event allocation) with a written usage justification; without it, batch the calls or shed load at the producer. Replay the failing call against the vendor sandbox + long-duration soak via k6 / JMeter / Postman Runner to confirm the new safe RPS before pushing to prod.
When the Apple App Store Connect (iOS app submission portal) fault tracks to webhook delivery failures, retry storms, or downstream timeouts, treat the integration plane as suspect. Open the webhook delivery log in the vendor dashboard (Stripe Events, Twilio Debugger, GitHub Webhooks deliveries, Atlassian webhook log, Slack Event Subscriptions) and read the response status your endpoint actually returned - most "webhook not firing" reports are actually "webhook firing but my endpoint 500ed and the vendor backed off." Verify the webhook signing secret matches what the vendor expects (Stripe whsec_..., GitHub HMAC-SHA256 with the configured secret, Slack signing secret v0). Confirm the retry policy: Stripe retries for 3 days with exponential backoff, GitHub retries 5 times over 8 hours, Twilio retries up to 4 times. Decision point: if the webhook endpoint is firing but the downstream is timing out, raise the endpoint timeout to at least 10 seconds and ack the webhook synchronously before doing real work async (queue + worker). Verify the firewall allowlist for vendor IP ranges is up to date (Stripe, GitHub, Atlassian, and Slack each publish a JSON of their egress ranges) and the corporate proxy bypass exempts those CIDRs - a webhook silently dropping at the perimeter looks identical to "your endpoint is broken."
Automate this fix so you do not do it twice
Fleet API key + OAuth credential rotation via vendor CLI
Rotating an API key on one Apple App Store Connect (iOS app submission portal) tenant by hand is fine; rotating across a fleet of tenants is how you end up with twelve different keys, four expired ones, and an unknown blast radius. Drive rotation through the vendor admin CLI or REST under a service account with the rotation scope only, hash the new credential into a secrets manager (AWS Secrets Manager, GCP Secret Manager, Azure Key Vault, HashiCorp Vault) with versioning enabled, and roll the consumer fleet one tenant at a time with a health check between each. Pin the API version header during rotation so a coincident vendor rollout does not look like a rotation failure.
# AWS - rotate an IAM access key with the old one still active for cutover
NEW=$(aws iam create-access-key --user-name svc-Apple App Store Connect (iOS app submission portal) --query AccessKey.AccessKeyId --output text)
aws secretsmanager update-secret --secret-id Apple App Store Connect (iOS app submission portal)/api --secret-string "$NEW"
# Deploy + health check, then disable the old key:
aws iam update-access-key --user-name svc-Apple App Store Connect (iOS app submission portal) --access-key-id $OLD --status Inactive
# GitHub - rotate a fine-grained PAT (REST)
gh api -X POST /user/personal-access-tokens \ -f name="Apple App Store Connect (iOS app submission portal)-prod-2026-05-31" -f expires_at="2026-08-31"
# Stripe - regenerate restricted key via CLI
stripe keys regenerate rk_live_XXXX --confirm
# Cycle webhook signing secret last (after consumer cutover)
stripe webhook_endpoints update we_XXXX --enabled-events charge.succeededScrape vendor admin audit log + webhook delivery via scheduled job
For the Apple App Store Connect (iOS app submission portal), integration faults usually surface as failed webhook deliveries, audit-log denials, or rate-limit 429 bursts before a full outage. A weekly scheduled job that exports the last 7 days of these events to CSV gives you a paper trail to correlate with SDK bumps, scope changes, and vendor incidents without staring at the admin console live. Register the task via cron (Linux), Windows Task Scheduler (schtasks /create /XML), or a GitHub Actions schedule, then write the CSV to S3 / GCS / OneDrive for retention. Subscribe a SIEM (Splunk, Datadog, Elastic) to the same bucket so audit events from every Apple App Store Connect (iOS app submission portal) tenant converge on a single dashboard without per-tenant scraping.
# Stripe Events via curl (last 7 days)
curl -G https://api.stripe.com/v1/events \ -u sk_live_XXXX: \ --data-urlencode "created[gte]=$(date -d '7 days ago' +%s)" \ --data-urlencode "limit=100" \ -o stripe-events-Apple App Store Connect (iOS app submission portal).json
# Salesforce Setup Audit Trail (sfdx)
sfdx force:data:soql:query \ -q "SELECT CreatedDate, Action, Section, CreatedBy.Name FROM SetupAuditTrail WHERE CreatedDate = LAST_N_DAYS:7" \ -r csv > sf-audit-Apple App Store Connect (iOS app submission portal).csv
# GitHub webhook deliveries (gh CLI)
gh api -X GET "repos/OWNER/REPO/hooks/HOOKID/deliveries" --paginate > gh-webhook-Apple App Store Connect (iOS app submission portal).jsonCodify the SDK pin and rollback as a single git revert
Once a stable SDK and API version is identified for the Apple App Store Connect (iOS app submission portal), commit the lockfile to a runbook repo with the date, the API version header, and the OAuth scope set in the commit message. Reproducible rollback is then a single git revert plus npm install or pip install. Pin the API version in the Authorization or version header explicitly so a vendor-side default change does not silently shift behavior under you. Stage the pinned dependency manifest next to a README that lists the failing correlation id, the vendor incident id (if any), and the support case number; the second time the integration breaks at 2 a.m. you do not want to be rediscovering which SDK version was actually green.
# package.json (Node)
# "stripe": "14.21.0", // Stripe-Version: 2024-12-18.acacia
# "@aws-sdk/client-s3": "3.620.0"
npm uninstall stripe && npm install [email protected]
# requirements.txt (Python)
# boto3==1.34.51
# twilio==9.3.0
pip uninstall -y boto3 && pip install boto3==1.34.51
# Salesforce CLI pin
sfdx force:doctor
# Tag the runbook entry: 2026-05-31_Apple App Store Connect (iOS app submission portal)_v60.0_scopes_offline_access
Common pitfalls and what to watch for
SDK upgrades during an active failure are the textbook way to brick a Apple App Store Connect (iOS app submission portal) integration, and the trap catches experienced engineers because the changelog looks like it describes exactly the bug at hand. Never bump a major SDK version while production is on fire, never push a beta SDK unless the vendor changelog ties it to a specific advisory for your symptom, and never roll forward when a rollback is available. Skipping a required API-version migration (Salesforce v60.0 metadata change, Stripe-Version pinning across a major release, Apple App Store Connect API v1.X scope tightening) leaves a known regression path open even after the immediate fix, so check the deprecation timeline on the vendor changelog before deciding to wait. Adobe 213.11 licensing errors and SAP Express RAISE OBJECT_NOT_FOUND on a recently patched tenant are documented examples where an upgrade caused, rather than fixed, the failure.
The other half is trusting the vendor status page verdict by itself. Vendor status pages can miss regional incidents that only hit one POP, the Trust Center will not flag a webhook delivery degradation, and the audit log entries can lag several minutes behind the actual failure. Cross-reference the vendor X/Twitter status handle, Downdetector, the failing correlation id timestamps, and the on-caller symptom narrative before committing to a destructive remediation on Apple App Store Connect (iOS app submission portal).
Verify the fix worked
- Reproduce the original failing call against Apple App Store Connect (iOS app submission portal) sandbox AND prod with the same payload. If the failing status code (Stripe 402, Salesforce INSUFFICIENT_ACCESS_OR_READONLY, AWS ThrottlingException, Webex 41001) still surfaces on any tenant in the fleet, you have not fixed it.
- Watch for 24 to 48 hours via the vendor admin console audit log + the webhook delivery log + your SIEM (Splunk, Datadog, Elastic). Cached error responses and CDN caches mask slow-burn drift and intermittent regional issues.
- Smoke-test under realistic load: replay against the vendor sandbox with k6 / JMeter / Postman Runner / Newman CLI for at least 30 minutes at production RPS, log p50/p95/p99 latency, status code, and rate-limit headers per response.
- Capture the new state in a runbook so the next on-caller does not rediscover this. Note SDK version + API version header + OAuth scope set + failing correlation id (x-request-id, x-amz-request-id, X-Salesforce-SFDC-RequestId) + verbatim error string + fix applied. Push to a shared wiki.
- If the fix involved an API key rotation or OAuth scope change, commit the new lockfile and scope list to the runbook repo and screenshot the admin console state for archival.
Safety, rollback, blast radius
- Test in the Apple App Store Connect (iOS app submission portal) sandbox first or behind a feature flag before any write that touches a prod tenant. Snapshot the SDK lockfile, the API version header, the OAuth scope set, and the IAM policy version before changing anything.
- Apply principle of least privilege when granting OAuth scopes or IAM roles. Review the scope list against the endpoints you actually call - extra scopes are extra blast radius.
- Stamp an idempotency key (Stripe Idempotency-Key, AWS ClientToken, Atlassian X-Atlassian-Token) on every retried POST so a retry storm cannot create duplicate charges or duplicate records.
- Know your rollback path. SDK pin rollback is a one-line git revert plus npm install / pip install; an API key rotation is reversible if you kept the old key Active during cutover; a webhook signing secret rotation is reversible only if you saved the previous secret in the secrets manager.
- For tenant-wide or org-wide changes, line up a maintenance window with stakeholder notification before pushing through Salesforce Setup, Microsoft 365 Admin Center, Google Workspace Admin, AWS Organizations, or Adobe Admin Console.
FAQ
References
- Vendor developer documentation for Apple App Store Connect (iOS app submission portal) (official API reference, SDK changelog, Trust Center)
- Developer forums (Stack Overflow, r/webdev, r/devops, r/sysadmin, vendor community Slack / Discord, brand-specific forums)
- Vendor status pages and X/Twitter status handles, vendor changelogs, and post-mortem incident reports
- OpenAPI / Swagger specs, OAuth scope reference, and admin console audit log documentation
Related fixes
Related guides worth a look while you sort this one out:
- How to fix Missing Push Notification Entitlement ITMS-90078
- How to set up TestFlight external testing groups
- How to submit an iOS app for review the right way
- How to fix Sign in with Apple invalid_client error
- How to fix Sign in with Apple invalid_grant authorization code reuse
- Connect Apple Health to mTrulicity