Skip to content

Set up App Store Connect

Before you can publish your iOS app, you need to create it in App Store Connect and generate the required certificates.

StepWhat’s doneDuration
1. Developer AccountJoin Apple Developer Program (incl. identity check)15 min – several days
2. Bundle IDCreate app identifier~5 min
3. Create AppCreate app in App Store Connect~15 min
4. API KeyKey for automatic uploads~10 min
5. CertificatesDistribution Certificate & Provisioning Profile~20 min

If you’re not a member yet, you first need an Apple ID with two-factor authentication enabled and you must pay the annual fee of $99.

There are two ways to enroll. The app route is the easiest for most individuals, because identity verification runs directly via Face ID / Touch ID.

  1. Download the “Apple Developer” app from the App Store onto your iPhone or iPad.
  2. Open the app and sign in with your Apple ID.
  3. Tap the Account tab → Enroll Now.
  4. Choose the account type:
    • Individual / Sole Proprietor: for individual developers
    • Organization: for companies (D-U-N-S number required)
  5. Follow the identity verification using Face ID / Touch ID and an ID scan.
  6. Pay the annual fee of $99.
  7. Wait for the confirmation email.

The Bundle ID uniquely identifies your app in the Apple ecosystem.

  1. Go to the Apple Developer Portal
  2. Navigate to Certificates, Identifiers & Profiles
  3. Click Identifiers in the sidebar
  4. Click the + symbol
  5. Select App IDs and click Continue
  6. Select App as type and click Continue
  7. Fill in the fields (see table below)
  8. Enable required Capabilities (see table below)
  9. Click Continue and then Register

Fields to fill in:

FieldDescriptionExample
DescriptionDescription of the appClub App
Bundle IDUnique ID (Explicit)com.yourcompany.app

Optional Capabilities:

CapabilityWhen to enable?
Push NotificationsIf your app uses push notifications
Sign In with AppleIf Apple Login is used
Associated DomainsFor Universal Links

  1. Go to App Store Connect
  2. Click My Apps
  3. Click the + symbol → New App
  4. Fill in the form (see table below)
  5. Click Create
FieldDescription
PlatformsSelect iOS
NameApp name in the store (max. 30 characters)
Primary LanguageEnglish
Bundle IDSelect the previously created Bundle ID
SKUUnique identifier (e.g., clubapp2024)
User AccessFull Access (default)

After creation, go to App StoreApp Information:

SectionRequired Information
GeneralSubtitle, category, age rating
App PrivacyLink to privacy policy (Required!)
Price and AvailabilityPricing model, countries

Go to App StorePrepare for Submission:

ElementRequirements
Screenshots (iPhone)6.7” and 5.5” (min. 3 per size)
Screenshots (iPad)Optional but recommended
Promotional TextMax. 170 characters
DescriptionMax. 4,000 characters
KeywordsMax. 100 characters (comma-separated)
Support URLLink to your support page
Marketing URLOptional

The API Key allows BLOCQ to automatically upload builds.

  1. Go to App Store Connect
  2. Click Users and Access
  3. Select the Integrations tab
  4. Click App Store Connect API
  5. Click Team Keys
  6. Click the + symbol
  7. Enter Name: “BLOCQ Publisher” and Access: “App Manager”
  8. Click Generate

After creation:

  1. Download API Key: Click Download (only possible once!)
    • The file is named AuthKey_XXXXXXXX.p8
    • Store it safely!
  2. Copy Key ID: Shown in the key’s row
  3. Copy Issuer ID: Shown at the top of the page

The certificate signs your app for the App Store.

  1. Open Keychain Access on your Mac

  2. Go to Keychain AccessCertificate AssistantRequest a Certificate from a Certificate Authority

  3. Fill in:

    • User Email Address: Your email
    • Common Name: Your name
    • Saved to disk: Enable
  4. Click Continue and save the .certSigningRequest file

  5. Go to the Apple Developer Portal

  6. Navigate to Certificates, Identifiers & ProfilesCertificates

  7. Click +

  8. Select Apple Distribution and click Continue

  9. Upload the .certSigningRequest file

  10. Click Continue and then Download

  11. Double-click the downloaded .cer file to install

  1. Open Keychain Access
  2. Find the installed certificate (e.g., “Apple Distribution: Your Name”)
  3. Expand the certificate to see the private key
  4. Select both (certificate + private key)
  5. Right-click → Export…
  6. Choose format .p12
  7. Set a password (remember it!)
  8. Save the file

The Provisioning Profile links certificate, Bundle ID, and devices.

  1. Go to the Apple Developer Portal
  2. Navigate to Certificates, Identifiers & ProfilesProfiles
  3. Click +
  4. Under Distribution: Select App Store Connect
  5. Click Continue
  6. Select your Bundle ID
  7. Click Continue
  8. Select your Distribution Certificate
  9. Click Continue
  10. Enter a Name (e.g., “ClubApp Distribution”)
  11. Click Generate and then Download

File/InfoFormatWhere to upload?
API Key.p8iOS Wizard → API Key
Issuer IDTextiOS Wizard → Account Info
Key IDTextiOS Wizard → Account Info
Distribution Certificate.p12iOS Wizard → Signature
Certificate PasswordTextiOS Wizard → Signature
Provisioning Profile.mobileprovisioniOS Wizard → Signature

Before returning to BLOCQ:

  • Apple Developer Program member
  • Bundle ID created (matching BLOCQ Package Name)
  • App created in App Store Connect
  • App information and store listing completed
  • API Key created and .p8 downloaded
  • Issuer ID and Key ID noted
  • Distribution Certificate created and exported as .p12
  • Provisioning Profile created and downloaded

Cause: The certificate has expired or wasn’t exported correctly.

Solution:

  1. Check the expiration date in Keychain
  2. Make sure you exported both (certificate + private key)
  3. Create a new certificate if needed

”Provisioning Profile doesn’t match Bundle ID”

Section titled “”Provisioning Profile doesn’t match Bundle ID””

Cause: The Bundle ID in the Provisioning Profile doesn’t match the app.

Solution:

  1. Check the Bundle ID in BLOCQ
  2. Create a new Provisioning Profile with the correct Bundle ID

Cause: The API Key was revoked or the IDs don’t match.

Solution:

  1. Check Issuer ID and Key ID in App Store Connect
  2. Create a new API Key if needed

Cause: Another app is already using this name in the store.

Solution:

  1. Choose a different app name
  2. The name must be unique across the entire App Store

After the first successful upload, your app appears in TestFlight.

  1. Go to App Store Connect
  2. Select your app
  3. Go to the TestFlight tab
  4. Wait for the build to be processed (10-30 min)
  5. Answer the compliance questions (encryption)
  6. Add testers (email addresses)
  7. Share the TestFlight link with your testers