Wow KeywordsGet lifetime · $99

Blog ·

App Store Connect API key: how to create one

An App Store Connect API key is a credential you generate in App Store Connect so scripts and tools can call Apple's API for your apps. It has three parts: a Key ID, an Issuer ID and a private .p8 file. Your Account Holder must request API access first.

How to create an App Store Connect API key

Apple's App Store Connect API help describes two kinds of key. A team key works across all your apps; an individual key belongs to one user.

  1. Request API access. Only the Account Holder can do this. In Users and Access, click Integrations, make sure App Store Connect API is selected, click Request Access, accept the terms and click Submit. Apple reviews each request case by case.
  2. Open Team Keys. The Account Holder or an Admin clicks Team Keys under Integrations, then Generate API Key. If you already have an active key, click the add button (+) instead.
  3. Name the key. The name is only for you and is not part of the key.
  4. Choose the access. Under Access, select the role permissions that decide what the key can do. A team key applies to every app, so you cannot limit it to one.
  5. Click Generate. You cannot edit the name or access afterwards. To change either, revoke the key and generate a new one.
  6. Download the .p8 file. Apple lets you download an API key only once, so save it somewhere private before you close the page. Copy the Key ID and the Issuer ID.

An individual key is made from your own profile instead: click your username, then Edit Profile, then Generate Key under Individual API Key. Each user can have one active individual key, and an Admin can switch this off for a user.

Add the key to Wow Keywords

Wow Keywords is a desktop app for App Store and Google Play optimization. It works without a key, reading your public listing. With a key it also reads your keyword field and uploads your listing, screenshots and prices.

You supply three things: the Issuer ID, the Key ID and the .p8 file. The key is encrypted on your computer with macOS Keychain or Windows account protection and is sent only to Apple.

Once saved, the key is checked with Apple. The app reports how many apps it sees, or why the check fails, such as a revoked key or a wrong Issuer ID.

If you work through an AI agent, the asc_connect tool in the MCP docs takes the Issuer ID and the path to the AuthKey_<id>.p8 file, and reads the Key ID from the file name.

Uploads happen only when you click Upload. You pick the languages and fields, and they are written to a new or draft version in App Store Connect. Nothing is submitted for review.

Which role should the key have

Apple's role permissions page lists eight roles: Account Holder, Admin, Finance, App Manager, Developer, Marketing, Sales and Customer Support. App Manager manages all aspects of an app, including pricing and App Store information, which is enough to write listings. App analytics (impressions, page views, downloads) are only shared with an Admin key: Apple requires the Admin role to request an app's analytics reports. Wow Keywords asks for Admin so one key covers both.

In Wow Keywords the check returns a 403 when the key's role is too narrow, and the Analytics tab asks for an Admin key when Apple refuses its reports. The fix is a new key with the Admin role, because a generated key cannot be edited.

What the Key ID, Issuer ID and .p8 file are

  • Key ID: names this one key. Apple also uses it in the .p8 file name, as AuthKey_<Key ID>.p8.
  • Issuer ID: identifies your team's account.
  • .p8 file: the private key. It proves that a request really comes from you.

Treat the .p8 file like a password. Keep it out of repositories, shared drives and chat, and put it in a secrets store when a CI job needs it.

If a key is lost, leaked or replaced

Apple says to revoke a key straight away if it is lost or compromised. An Account Holder or Admin does this under Integrations: choose Team Keys or Individual Keys, click Edit, select the key and click Revoke Key. A revoked key cannot be reinstated, and it stays visible under Revoked for 30 days.

Then generate a new key and save it in the tool. Saving the same key again in Wow Keywords updates its saved account.

Before the first upload, prepare what you will write with your app's metadata and decide your languages with App Store localization.

FAQ

Who can create an App Store Connect API key?

The Account Holder requests API access for the team, and once it is approved an Account Holder or Admin can generate team keys. Users with the Account Holder, Admin, App Manager, Customer Support, Developer or Marketing role can generate an individual key unless an Admin has turned that off.

Do I need an API key to research App Store keywords?

No. Tracking public apps and keywords in Wow Keywords needs no key, and you can export everything to fastlane without one. The key is optional and adds reading your keyword field and uploading.

Will uploading with the key submit my app for review?

No. Wow Keywords writes only when you click Upload, and only the languages and fields you picked. It fills a new or draft version and never submits it for review.

Can I limit a team key to one app?

No. Apple applies team keys across all apps, so app access cannot be limited for a key. The role you choose is the only control over what it can do.