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.
Overview
Section titled “Overview”| Step | What’s done | Duration |
|---|---|---|
| 1. Developer Account | Join Apple Developer Program (incl. identity check) | 15 min – several days |
| 2. Bundle ID | Create app identifier | ~5 min |
| 3. Create App | Create app in App Store Connect | ~15 min |
| 4. API Key | Key for automatic uploads | ~10 min |
| 5. Certificates | Distribution Certificate & Provisioning Profile | ~20 min |
Step 1: Apple Developer Program
Section titled “Step 1: Apple Developer Program”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.
- Download the “Apple Developer” app from the App Store onto your iPhone or iPad.
- Open the app and sign in with your Apple ID.
- Tap the Account tab → Enroll Now.
- Choose the account type:
- Individual / Sole Proprietor: for individual developers
- Organization: for companies (D-U-N-S number required)
- Follow the identity verification using Face ID / Touch ID and an ID scan.
- Pay the annual fee of $99.
- Wait for the confirmation email.
- Go to developer.apple.com/enroll
- Click Start Your Enrollment and sign in with your Apple ID.
- Choose the account type (Individual or Organization).
- Provide your legal name, phone number and address.
- Complete the identity verification (ID upload if requested).
- Accept the license agreement and pay the annual fee of $99.
- Wait for confirmation (can take from hours to several days).
Step 2: Create Bundle ID
Section titled “Step 2: Create Bundle ID”The Bundle ID uniquely identifies your app in the Apple ecosystem.
- Go to the Apple Developer Portal
- Navigate to Certificates, Identifiers & Profiles
- Click Identifiers in the sidebar
- Click the + symbol
- Select App IDs and click Continue
- Select App as type and click Continue
- Fill in the fields (see table below)
- Enable required Capabilities (see table below)
- Click Continue and then Register
Fields to fill in:
| Field | Description | Example |
|---|---|---|
| Description | Description of the app | Club App |
| Bundle ID | Unique ID (Explicit) | com.yourcompany.app |
Optional Capabilities:
| Capability | When to enable? |
|---|---|
| Push Notifications | If your app uses push notifications |
| Sign In with Apple | If Apple Login is used |
| Associated Domains | For Universal Links |
Step 3: Create App in App Store Connect
Section titled “Step 3: Create App in App Store Connect”- Go to App Store Connect
- Click My Apps
- Click the + symbol → New App
- Fill in the form (see table below)
- Click Create
| Field | Description |
|---|---|
| Platforms | Select iOS |
| Name | App name in the store (max. 30 characters) |
| Primary Language | English |
| Bundle ID | Select the previously created Bundle ID |
| SKU | Unique identifier (e.g., clubapp2024) |
| User Access | Full Access (default) |
Fill in App Information
Section titled “Fill in App Information”After creation, go to App Store → App Information:
| Section | Required Information |
|---|---|
| General | Subtitle, category, age rating |
| App Privacy | Link to privacy policy (Required!) |
| Price and Availability | Pricing model, countries |
Create Store Listing
Section titled “Create Store Listing”Go to App Store → Prepare for Submission:
| Element | Requirements |
|---|---|
| Screenshots (iPhone) | 6.7” and 5.5” (min. 3 per size) |
| Screenshots (iPad) | Optional but recommended |
| Promotional Text | Max. 170 characters |
| Description | Max. 4,000 characters |
| Keywords | Max. 100 characters (comma-separated) |
| Support URL | Link to your support page |
| Marketing URL | Optional |
Step 4: Create API Key
Section titled “Step 4: Create API Key”The API Key allows BLOCQ to automatically upload builds.
- Go to App Store Connect
- Click Users and Access
- Select the Integrations tab
- Click App Store Connect API
- Click Team Keys
- Click the + symbol
- Enter Name: “BLOCQ Publisher” and Access: “App Manager”
- Click Generate
Copy Key and IDs
Section titled “Copy Key and IDs”After creation:
- Download API Key: Click Download (only possible once!)
- The file is named
AuthKey_XXXXXXXX.p8 - Store it safely!
- The file is named
- Copy Key ID: Shown in the key’s row
- Copy Issuer ID: Shown at the top of the page
Step 5: Create Certificates
Section titled “Step 5: Create Certificates”Distribution Certificate
Section titled “Distribution Certificate”The certificate signs your app for the App Store.
-
Open Keychain Access on your Mac
-
Go to Keychain Access → Certificate Assistant → Request a Certificate from a Certificate Authority
-
Fill in:
- User Email Address: Your email
- Common Name: Your name
- Saved to disk: Enable
-
Click Continue and save the
.certSigningRequestfile -
Go to the Apple Developer Portal
-
Navigate to Certificates, Identifiers & Profiles → Certificates
-
Click +
-
Select Apple Distribution and click Continue
-
Upload the
.certSigningRequestfile -
Click Continue and then Download
-
Double-click the downloaded
.cerfile to install
Export Certificate as .p12
Section titled “Export Certificate as .p12”- Open Keychain Access
- Find the installed certificate (e.g., “Apple Distribution: Your Name”)
- Expand the certificate to see the private key
- Select both (certificate + private key)
- Right-click → Export…
- Choose format .p12
- Set a password (remember it!)
- Save the file
Provisioning Profile
Section titled “Provisioning Profile”The Provisioning Profile links certificate, Bundle ID, and devices.
- Go to the Apple Developer Portal
- Navigate to Certificates, Identifiers & Profiles → Profiles
- Click +
- Under Distribution: Select App Store Connect
- Click Continue
- Select your Bundle ID
- Click Continue
- Select your Distribution Certificate
- Click Continue
- Enter a Name (e.g., “ClubApp Distribution”)
- Click Generate and then Download
Summary: What You Need for BLOCQ
Section titled “Summary: What You Need for BLOCQ”| File/Info | Format | Where to upload? |
|---|---|---|
| API Key | .p8 | iOS Wizard → API Key |
| Issuer ID | Text | iOS Wizard → Account Info |
| Key ID | Text | iOS Wizard → Account Info |
| Distribution Certificate | .p12 | iOS Wizard → Signature |
| Certificate Password | Text | iOS Wizard → Signature |
| Provisioning Profile | .mobileprovision | iOS Wizard → Signature |
Checklist
Section titled “Checklist”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
Common Problems
Section titled “Common Problems””Invalid Certificate”
Section titled “”Invalid Certificate””Cause: The certificate has expired or wasn’t exported correctly.
Solution:
- Check the expiration date in Keychain
- Make sure you exported both (certificate + private key)
- 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:
- Check the Bundle ID in BLOCQ
- Create a new Provisioning Profile with the correct Bundle ID
”API Key not found”
Section titled “”API Key not found””Cause: The API Key was revoked or the IDs don’t match.
Solution:
- Check Issuer ID and Key ID in App Store Connect
- Create a new API Key if needed
”App name already taken”
Section titled “”App name already taken””Cause: Another app is already using this name in the store.
Solution:
- Choose a different app name
- The name must be unique across the entire App Store
Prepare TestFlight
Section titled “Prepare TestFlight”After the first successful upload, your app appears in TestFlight.
- Go to App Store Connect
- Select your app
- Go to the TestFlight tab
- Wait for the build to be processed (10-30 min)
- Answer the compliance questions (encryption)
- Add testers (email addresses)
- Share the TestFlight link with your testers