Documentation

App Store Connect Setup Guide

Configure your Apple Developer account for automatic builds

Prerequisites

  • Apple ID: A valid Apple ID with Two-Factor Authentication enabled.
  • Developer Program Membership: You must be enrolled in the Apple Developer Program ($99/year). This is required to distribute apps on the App Store.

Step 1: Register your App ID

Before we can build your app, Apple needs to know it exists. You must register the Bundle ID on the Developer Portal.

  1. Go to Certificates, Identifiers & Profiles.
  2. Click the (+) button next to Identifiers.
  3. Select App IDs and click Continue.
  4. Select App and click Continue.
  5. Enter a Description (e.g., "My Web App").
  6. For Bundle ID, select "Explicit" and enter your unique identifier (e.g., com.yourcompany.appname).
    Important: This MUST match the Bundle ID you enter in the WebToApp dashboard.
  7. Enable Capabilities - scroll down to the Capabilities section and enable:
    • App Groups - Required for sharing data between app extensions
    • Push Notifications - Required for OneSignal integration
  8. Click Continue and then Register.

Step 2: Create App on App Store Connect

Now create the app listing on App Store Connect so you can upload builds.

  1. Go to App Store Connect → Apps.
  2. Click the (+) button and select New App.
  3. Fill in the details:
    • Platforms: iOS
    • Name: Your app's display name
    • Primary Language: Select your primary language
    • Bundle ID: Select the Bundle ID you created in Step 1
    • SKU: A unique identifier for your app (e.g., myapp-001)
    • User Access: Full Access (recommended)
  4. Click Create.
Note: After creating the app, you can optionally set up TestFlight groups, add metadata, and configure App Store listing details.

Step 3: Create App Store Connect API Key

WebToApp uses this key to automatically manage certificates, profiles, and upload your build.

  1. Go to App Store Connect > Users and Access > Integrations > App Store Connect API.
  2. Click the (+) button to generate a new API Key.
  3. Enter a name (e.g., "WebToApp Builder").
  4. Access: Select Admin.
    Why Admin? We need this permission to automatically create provision profiles and certificates for you. Without it, the build will fail.
  5. Click Generate.

Step 4: Download Credentials

Once the key is created, you need to gather three pieces of information for the WebToApp dashboard:

1. Issuer ID
Found at the top of the Keys page. UUID format.
2. Key ID
10-character ID shown in the key list row.
3. Team ID
Found on your Membership Details page. 10-character alphanumeric ID.
4. Private Key (.p8 file)
Click "Download API Key" next to your key.
⚠️ Warning: You can only download this file ONCE. Keep it safe!

Step 5: Configure WebToApp

Return to the iOS Tab in the dashboard and enter the credentials you just gathered.

Troubleshooting

Error: "App ID not found on Developer Portal"

You need to create the App ID on the Apple Developer Portal before building. Follow Step 1 above. Make sure the Bundle ID in the WebToApp dashboard matches exactly what you registered.

Error: "Bundle identifier not available"

This usually means someone else has already taken this Bundle ID. You must choose a different, unique ID in the Apple Developer Portal and update it here.

Error: "Team ID mismatch"

Ensure you copied the Team ID from your Membership Details page, not the Header of some other page.

Push Notifications not working

Make sure you enabled the Push Notifications capability when creating your App ID. You can edit the App ID later at Certificates, Identifiers & Profiles.

WebToApp - Convert Any Website to iOS & Android Apps