How to create an App Store Connect API key
What the key is, in plain terms
An App Store Connect API key lets an app read your data from Apple without your Apple ID password. It has three parts:
- The Key ID: a short code that names the key.
- The Issuer ID: a longer code that identifies your team.
- The private key file: a small
.p8file you download once. Treat it like a password.
Which role to pick
Kiikari supports both of these, and tells you during onboarding what your key can do:
- Admin is the one we recommend. It turns on Apple's analytics reports, reads every number and posts your review replies. Apple only lets an Admin key switch the analytics reports on, so no other role can do that. Kiikari still never changes your apps, pricing, metadata or availability. Its only writes are turning on Apple's analytics reports (once per app, new apps too) and posting the replies you write.
- Sales and Reports is read-only, the cautious choice. You get sales, proceeds, refunds, a read-only reviews inbox, and analytics only for apps whose reports are already on. Replies and the live app status stay off. If Apple refuses to turn the analytics reports on, Kiikari says "Turning on Apple's analytics reports needs an Admin key. Sales and reviews still work." instead of failing.
Not sure? Start with Sales and Reports and swap in an Admin key later in one step. Once the analytics reports are on for your apps, a Sales and Reports key can read them.
Step by step
- Sign in to App Store Connect and open Users and Access.
- Select the Integrations tab, then App Store Connect API.
- Under Team Keys, click the add button to generate a key. Only an Admin or the Account Holder can do this. If that is not you, ask an Admin to create the key and send you the
.p8file. - Give it a name you will recognize, such as "Kiikari", and set the access to Admin (or Sales and Reports for read-only).
- Click Generate. Then Download the
.p8file. You can only download it once, so keep it somewhere safe. - Note the Key ID next to your new key, and the Issuer ID shown at the top of the keys list.
Add it to Kiikari
Open Kiikari's onboarding, drop in the .p8 file, and paste the Key ID and Issuer ID. Kiikari validates the key against Apple immediately and shows you what it can do. If anything is off, it tells you which part and why, in plain language.
Frequently asked
Is this key safe to give a third-party app?
A read-only Sales and Reports key is the safest kind, and Kiikari fully supports it. An Admin key can do more, so Kiikari keeps its use small. It never changes your apps, pricing, metadata or availability. Its only writes are turning on Apple's analytics reports (once per app, new apps too) and posting the review replies you write. Either way the key never leaves your Mac: it lives in the Keychain and is used only to sign requests to Apple. Kiikari has no backend for it to travel to.
I lost the .p8 file. What now?
You cannot re-download a key file. Revoke the old key in App Store Connect and generate a fresh one. It takes the same two minutes.
What is the vendor number?
It is the ID Apple attaches to your sales reports. Kiikari asks for it during setup and points you to App Store Connect: under Reports, open Payments and Financial Reports; it is shown as Vendor # at the top. One paste, once.