Prerequisites
Before you can connect your Apple Developer account you'll need to register for the Apple Developer Program.
You'll need to be the Account Holder to complete the steps in your Apple Developer account.
How to Connect Your Apple Developer Account
Warning
If you experience an issue with any of the connection steps, please save your progress, then start a chat with our team and share a screen recording of the issue.
Step 1 - Start connecting your account
Note
If you previously connected an account before September 2023 you still need to connect to the new App Setup to receive updates.
Go to Design > App > App Setup.
Under Connect Accounts, click 'Connect Apple Account'.
Click the Connect New Account button. If you have previously used this new process to connect another channel, select Select Existing Account.
Give your account a Reference Name. This is used to identify the Apple Developer account within SupaPass. Use an appropriate name, such as your company name.
Top Tip! 😊 We recommend setting up your two browser windows side by side
Have your SupaPass Dashboard open on left side of your computer screen
Have your Apple App Store Connect dashboard open on the right side of your computer screen
so you can easily move between both dashboards - we will be copying and pasting various IDs and other information, so having easy access to both will be really helpful.
Step 2 - Generate the API key file
Now, login to your App Store Connect with your Apple Developer account credentials.
Under the App Store Connect section, click 'Users and Access'.
Click on the 'Integrations' tab, then click 'Team Keys' and click 'Generate API Key' (or the plus button if you already have an active key). If this is the first time your team is using the App Store Connect API, the Account Holder will first need to click 'Request Access', agree to the terms and click 'Submit'.
To generate a new API Key, enter a sensible name for the key and give the access level 'Admin'. Then click the Generate button.
Hover over the entry in the table, click 'Download API Key' and keep it somewhere secure. Save with the original file name, or else the account connection will fail.
Return to the SupaPass Dashboard and upload the Key file (.p8).
Step 3 - Add the App Store Connect API Key ID
Next, copy and paste the App Store Connect API Key ID which can be found on the same page in App Store Connect.
Step 4 - Add the Issuer ID
Now, copy and paste the Issuer ID which can be found on the same page in App Store Connect.
Step 5 - Generate the Shared Secret
In App Store Connect, navigate to Users and Access
Click on the tab 'Integrations'
In the sidebar, under Keys, click 'Shared Secret', then click 'Generate Primary Shared Secret'.
Copy the Shared Secret and paste it into the Shared Secret field in SupaPass.
Note: Apple has updated App Store Connect since this video was recorded. You'll now find Shared Secret in the sidebar of the Integrations tab, under Keys.
Step 6 - Add the Account Holder's Apple ID
Return to App Store Connect and click on the 'People' tab.
Click on the Account Holder profile.
Copy the Apple ID Email address and paste it into the field in SupaPass.
Give the account a reference name and click 'Next'.
Step 7 - Upload APNs API Key file
The final three steps are to set up the notifications for your app and add some developer information.
IMPORTANT: These next steps relate to your Apple Developer account, not App Store Connect.
Login to developer.apple.com and click 'Keys' under the Certificates, IDs & Profiles section.
Click the blue plus button to generate a new Key.
Give the Key a name, select 'Apple Push Notification service (APNs)', click 'Configure' and choose Production as the environment, then review the key configuration and click 'Confirm'.
On the next screen you'll have the option to download the key, which cannot be re-downloaded. So download the key file and keep it somewhere secure. Save with the original file name, or else the account connection will fail.
Upload the key file to SupaPass. Make sure that the key is the newly generated .p8 file and not the same key generated in Step 2. You can check you're uploading the correct file as the file name will match the Key ID from the Keys page in Certificates, Identifiers & Profiles in your Apple Developer account.
Step 8 - Add your Apple Developer information
As before, this step relates to your Apple Developer account, not App Store Connect.
Login to developer.apple.com and click 'Membership details'.
Copy the Team ID.
Paste the Team ID into SupaPass.
Step 9 - Add your Entity Name or your name
Next, return to your Apple Developer Membership details.
If you're enrolled as an Organization: - Copy the Entity Name,
If you're enrolled as an individual: - use the Developer Name in the top right (this is your personal name that you registered with).
Paste the name into SupaPass.
Step 10 - Add your Company Name
If you enrolled in the Apple Developer Program as an Organization, you may set a different developer name if it's a registered trade name, DBA, or fictitious business name. For example, if your legal name is “Apps Company LLC”, your trade name may simply be “Apps Company”, which can be used on the App Store. It can't be edited or updated later, so it's important to add it correctly.
If you are using a Personal account, or are connecting an account that already has apps you will not be able to set a Company Name. Simply add the same name you used in the previous step.
Step 11 - Submit to connect your account
Check all of the details are correct and then click 'Submit' to connect your account to SupaPass.
Step 12 - Secure the API Keys
You should now take steps to secure the API keys downloaded to your device, this key cannot be downloaded again and is highly sensitive, so either delete it after connecting your account or store it securely in a password manager such as 1Password.
🚀 That's it! You've now given SupaPass access to automatically generate your app builds directly from your SupaPass Dashboard!
Frequently Asked Questions
Can't find what you need? Browse the answers below, or start a chat 💬
Who needs to complete these steps in my Apple account?
Who needs to complete these steps in my Apple account?
Only the Account Holder can request access to the App Store Connect API, so it's easiest if the Account Holder completes these steps. Account Holders and Admins can generate API keys and push notification keys.
What if I lose my push notification (.p8) key file?
What if I lose my push notification (.p8) key file?
Apple doesn't keep a copy of the key, so it can't be downloaded again. Create a new key in Certificates, Identifiers & Profiles and get in touch with our team so we can help you update your connection.
Where do I find my Team ID?
Where do I find my Team ID?
Sign in to your Apple Developer account and click Membership details. Your Team ID is listed there.
Can I change my company name on the App Store later?
Can I change my company name on the App Store later?
No. If you enrolled as an organization, you can set a different developer name (such as a registered trade name) only when adding your first app, and it can't be edited later. If you enrolled as an individual, your legal name is used.
Does SupaPass need my Apple password?
Does SupaPass need my Apple password?
No. You create and own your Apple Developer account, and SupaPass doesn't need or store your passwords. You connect your account using the keys and IDs in this guide.


