To submit your iOS app, link your own Apple Developer account. You will create two different keys, which both download as a .p8 file.
An App Store Connect API key lets us upload and manage your app. You create this in App Store Connect.
An Apple Push (APNs) p8 key is optional, and is only for push notifications. You create this in your Apple Developer account.
You need a paid Apple Developer Program membership ($99 per year) and must be the Account Holder or an Admin. Store each .p8 file safely: Apple only lets you download it once.
Where to enter this in AppInstitute
In the app editor, go to Build, then Publish, then Submit App. Click Go to step 4 (App Store Account). In the iOS card, click the green Add/Manage App Store Credentials button.
1. Request access (first time only)
Only the Account Holder can do this, and only once per Apple team. Sign in to App Store Connect, open Users and Access, then click Integrations. If you see Request Access, click it, agree to the terms, and click Submit. If you cannot see an Issuer ID afterwards, this step may still be pending.
2. Create a Team Key and download it
Use a Team Key, not an Individual API Key from your profile.
In Users and Access, go to Integrations, then App Store Connect API, then Team Keys.
Click Generate API Key, or the add button (+) if you already have a key. Name it AppInstitute. Under Access, choose App Manager or Admin, then click Generate.
Click Download API Key and store the .p8 file. You cannot download it again.
Copy the Issuer ID from near the top of the page, and the Key ID from the Active list.
3. Make sure this app's App ID is in your Apple account
We read your Team ID from this app's App ID in Apple's Developer portal. If that App ID is not in your account, Team ID will show as "Not detected yet".
Note the bundle ID shown for your app in AppInstitute. If you cannot see it, contact us and we will send it to you. Sign in at developer.apple.com/account, open Certificates, Identifiers & Profiles, then Identifiers, and select the team that should own this app. If the App ID is listed, continue. If not, click +, register an App ID of type App, enter that exact bundle ID, turn on Push Notifications if you want them, and register it.
If this app was previously submitted through an invitation to our Apple account, the App ID may still sit in our team rather than yours. Contact us first and we will help.
4. Upload the API key in AppInstitute
Open Add/Manage App Store Credentials, click Upload API key (or Replace API key if a key is already there), and choose the App Store Connect .p8 file from step 2. Check that Key ID and Issuer ID are correct, then click Check again.
Team ID should then show your 10-character Apple Team ID. If it still says "Not detected yet", follow step 3, then press Check again. When you are finished, click Done, then click Save on the step 4 page.
5. Optional: upload your Apple Push (APNs) p8 key
In the Apple Developer portal, go to Certificates, Identifiers & Profiles, then Keys, then click +. Name the key, tick Apple Push Notification service (APNs), and choose the environment (include Production if your app is on the App Store). Register the key and download it once. Then use Upload Key in the Push notifications key section and upload that APNs .p8 file.
Troubleshooting
Apple rejected the API key. You may see: "Needs attention: Key XXXX — Apple rejected the API key. Check the Issuer ID and Key ID match the .p8 file, and that the key still exists in App Store Connect with Admin or App Manager access." Follow that advice, accept any pending agreements, then click Check again. If you previously used an invitation to our account, create a new Team Key in your own App Store Connect and click Replace API key first.
Team ID shows "Not detected yet." Create or confirm the App ID in your account (step 3), then press Check again. If the app was first submitted through our invitation, contact us.
You cannot see an Issuer ID. The Account Holder may still need to click Request Access, or you may be looking at an Individual API Key or the wrong team. Copy the Issuer ID from near the top of Users and Access, then Integrations, then App Store Connect API.
Checklist
Paid Apple Developer Program membership, and agreements accepted.
Account Holder has requested App Store Connect API access.
A Team Key with App Manager or Admin access has been created, and the .p8 downloaded.
This app's App ID exists in your own Apple Developer account.
The API key has been uploaded in Add/Manage App Store Credentials, and Check again shows your Team ID.
Optional: a separate APNs key has been uploaded for push notifications.
Save the page and let us know, and we will submit your app to Apple.
