How to create an App Store Connect API key

Kiikari works best with an Admin key. A read-only Sales and Reports key works too, with one limit explained below. This takes about two minutes either way.

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:

Which role to pick

Kiikari supports both of these, and tells you during onboarding what your key can do:

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

  1. Sign in to App Store Connect and open Users and Access.
  2. Select the Integrations tab, then App Store Connect API.
  3. 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 .p8 file.
  4. Give it a name you will recognize, such as "Kiikari", and set the access to Admin (or Sales and Reports for read-only).
  5. Click Generate. Then Download the .p8 file. You can only download it once, so keep it somewhere safe.
  6. 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.

← Back to Kiikari