XToGoSupport
Report a problem — replies usually within a couple of days. One page for App CI, App Reviews and App Finances.
Getting set up
1. Create a key in App Store Connect
None of these apps can be reached with an Apple Account — a key is the only way in, and that's Apple's rule, not ours. In App Store Connect, go to Users and Access → Integrations → App Store Connect API and create a key. Which role it needs depends on what you want to do with it; see the roles table below.
Download the key file straight away — Apple allows exactly one download, and there is no way to get it back later. Note the issuer ID shown at the top of the page and the key ID in the key's row.
2. Add it once, in any of the three
Open Settings → Add account and start with the key file:
tap Choose .p8 File and pick the one you downloaded. If it
still has the name App Store Connect gave it —
AuthKey_XXXXXXXXXX.p8 — the key ID fills itself in, so the
issuer ID is the only thing left to paste. Name the account if you like, and
that's the whole of setup.
Do this once for the family. App CI, App Reviews and App Finances share one account list, so a team added in any of them appears in the others already signed in. With iCloud on, it also reaches your other Apple devices by itself, so the Mac is set up by the time you open it. With iCloud off, add the key on each device.
3. App Finances also needs a vendor number
Sales reports are filed under a vendor number, and Apple's API has no way to look it up, so App Finances asks for it once per team. It's the number at the top left of Payments and Financial Reports in App Store Connect. It syncs with the rest of the account, so the iPad and the watch don't ask again. The other two apps never need it.
4. Switch teams
A key belongs to one team, so add one per team. Switch between them from the account menu in the navigation bar and everything on screen follows — in whichever of the apps you are in at the time.
Which role the key needs
Reading builds, reading reviews and reading sales are three separate permissions in App Store Connect. One key can hold all of them, but a key made for one job may not do another — which is the single most common reason a screen comes up empty.
| To do this | The key needs |
|---|---|
| App CI — read products, runs, issues, tests, logs | A role that can see Xcode Cloud |
| App CI — start a build | The same, with write access |
| App Reviews — read reviews | Any role |
| App Reviews — post, edit or delete a reply | Admin, App Manager or Customer Support |
| App Finances — read sales and proceeds | Admin, Finance or Sales |
A key that isn't allowed to do what you asked gets a refusal from Apple, and each app repeats it in plain words rather than showing you an empty list. If that happens, the fix is in App Store Connect: change the key's role, or make a second key with the role you need and add it as another account.
When something looks wrong
"Not authorised", or an empty list
Usually the key's role — check it against the table above. Failing that, confirm the issuer ID and key ID came from the same page as the key file you downloaded.
App CI: Start Build is unavailable
Two things switch it off. Starting builds is part of App CI Pro, so the free version offers the purchase instead. With Pro, it's the key: read-only keys can look but not touch, so create one that's allowed to write to Xcode Cloud, or start the build from Xcode instead.
App CI: a run's issue counts show "—"
That's not a bug. Counts are reported for each step of a run, not for the run as a whole, so open a step to see its errors, warnings, analyzer warnings and test failures. A dash means nobody told us a number — better than showing four zeroes that were never counted.
App CI: a running build isn't updating
A run that hasn't finished refreshes itself every few seconds. Nothing pushes updates the instant they happen, so pull to refresh if you'd rather not wait.
App Reviews: the reply button is refused
Replying needs Admin, App Manager or Customer Support. Reading reviews needs none of those, which is why the list can be full and the reply still refused. Change the key's role in App Store Connect and it starts working — nothing in the app needs setting up again.
App Reviews: an app shows fewer reviews than App Store Connect does
Apple hands them over newest first, and the app takes the newest thousand per app. When it stops there it says so at the foot of the list rather than pretending that was all of them.
App Finances: today is missing
Apple writes each day's report the following morning, so the most recent day you can see is yesterday. Until the report exists the screen says it is pending — it isn't a zero, and it isn't lost.
App Finances: the total isn't what Apple paid me
It isn't meant to be. Apple pays each region in its own currency; the app converts those to the one currency you chose, at European Central Bank reference rates, so that a single number is possible at all. That is not the rate Apple applies on payout day, and every screen that shows a converted total says so underneath.
An account I added elsewhere hasn't turned up
Syncing needs the same Apple Account on both devices, with iCloud Keychain and iCloud Drive turned on in system settings. It can also just be slow — iCloud decides when to deliver. If it still hasn't arrived, add the key on that device yourself; nothing is lost by doing so.
Free and Pro
Each app is free, sells its own upgrade, and none of them is a way to unlock another. There is no bundle: buy the ones you use.
- App CI Pro — monthly, yearly, or a one-off lifetime purchase. Free holds one team and your first two apps, with every screen behind them: runs, actions, issues, tests, artifacts and the full logs. Pro adds the rest of your apps, as many teams as you work with, starting builds, build notifications and the Live Activity.
- App Reviews Pro — one yearly subscription. Reading, filtering, searching, ignoring and replying by hand are free for every app. Pro adds translation, saved replies, and the figures for every app and every storefront rather than the first few.
- App Finances Pro — one yearly subscription. Free covers one team, your first two apps, the 7- and 30-day windows, and every territory but the three biggest. Pro removes those limits and unlocks the watch app.
A purchase belongs to your Apple Account, not to a device, so it's already there when you open the app on the iPad or the Mac. If it isn't, open the paywall — from any locked feature — and tap Restore Purchases. Subscriptions are managed in the App Store, under your account's Subscriptions; these apps can't cancel one for you.
Removing an account
Because the three apps share one account list, deleting an account removes it and its key from all of them, on that device and the others it synced to. Deleting a single app removes that app's own data, including any artifacts or cached reports it kept. If the key itself should stop working, revoke it in App Store Connect — that is the only place a key can be revoked.
Requirements
- iOS or iPadOS 26 or later; macOS 26 or later on the Mac; watchOS 26 or later for App Finances on the wrist.
- An Apple Developer account — and, for App CI, Xcode Cloud set up on it.
- An App Store Connect key with a role that covers what you want to do; see the table above.
- A vendor number per team, for App Finances only.
Still stuck?
Report a problem, or find me on X. The same form is in each app under Settings › Report a Problem, where it arrives with your app version already filled in. Please say which app and which system version you are on, and what you were doing at the time. Never send the key file itself — it is never needed to work out what went wrong.