01Who this is for
- Agency Founders who white label apps for clients, because they need a repeatable way to set up Apple credentials.
- SaaS product owners deploying a custom iOS client, since the flow streamlines future updates.
- Marketing consultants managing multiple client apps, because one API key can serve several projects.
02Apple appstore linking, explained
The flow is a one time wizard inside HighLevel’s Mobile App Builder. It collects an App Store Connect API key, a unique bundle identifier, and Firebase configuration files. Once entered, HighLevel can compile the app, sign it with Apple, and enable services like push notifications without manual steps.
The wizard lives in the Mobile App Customizer under the App Store Connection section. It validates the data against your Apple Developer account and Firebase project, rejecting mismatches before the build starts. After successful validation, future releases are generated automatically.
03How businesses use the appstore onboarding flow
- Digital marketing agency. The agency creates an API key once, registers a distinct bundle ID for each client app, and uploads the matching Firebase plist. All actions occur inside HighLevel, allowing the agency to push updates for every client without re entering credentials.
- Franchise network. The network registers a single bundle identifier that all franchisee apps share, uploads the shared Firebase configuration, and lets HighLevel build and distribute the app across the franchise. Each new version uses the same stored credentials.
- SaaS startup. The startup generates an API key, registers its product’s bundle ID, and links the Firebase project. HighLevel then handles iOS builds and push notification setup, keeping the startup focused on core features.
04The numbers and rules that matter
- Key ID, Issuer ID, and downloaded.p8 file can be downloaded only once.
05Before you start
- An Apple Developer Program account with Admin access must exist before starting.
- The same Google account must be used for all Firebase steps to avoid permission problems.
06How to set up and use the appstore onboarding flow in HighLevel
Generate an App Store Connect API key
- Open the Apple portal at https://appstoreconnect.apple.com/access/integrations/api and land on the Users and Access › Keys page.
- In the left sidebar under App Store Connect API, select Keys.
- Click Generate API Key, give it a recognizable name, and confirm creation.
- Download the .p8 file that appears only once and store it securely.
- Copy the displayed Key ID and note the Issuer ID shown at the top of the page.
- In HighLevel’s Mobile App Builder, expand the App Store Connection area and upload the Key ID, Issuer ID, and the .p8 file.
- Note: one API key can be used for multiple apps; if it is compromised, revoke it in App Store Connect and create a new one.
Register the Bundle Identifier
- Enter the App Setup stage of the HighLevel wizard and locate the Package Name / Bundle Identifier field.
- Click Register to open the validation dialog linked to your Apple account.
- Enter a reverse DNS identifier such as com.youragency.appname, using only lowercase letters, numbers, and periods.
- Click the small info icon to read Apple’s explanation of bundle identifiers and why they must be unique.
- Save the entry; HighLevel will attempt to create the identifier in Apple Developer and will show an error if the string is already taken.
- Optionally, later enable services like Apple Sign In or Push Notifications through the Apple Developer portal.
Upload Firebase configuration files
- Navigate to https://firebase.google.com/, click Go to console, and sign in with the chosen Google account.
- Create a new Firebase project or open an existing one that will host the app.
- Click Add App, select iOS, and provide the bundle identifier from the previous step.
- Download the generated GoogleService Info.plist file, keeping its original name.
- Return to HighLevel’s Firebase setup stage, drag the plist file onto the upload area, and press Continue.
- Wait for validation; HighLevel will verify that the bundle identifier matches the one registered in Apple Developer before enabling push notifications and analytics.
07Settings that matter
- App Store Connection. Stores the App Store Connect API key, its Key ID, Issuer ID, and the .p8 credential file for automatic app signing.
- Package Name / Bundle Identifier. Defines the unique reverse DNS identifier that Apple and Firebase use to match the app across services.
- Firebase configuration upload. Accepts the GoogleService Info.plist file which supplies Firebase project credentials for push notifications, analytics, and crash reporting.
08Things to know before you rely on it
- Apple permits the .p8 file to be downloaded only a single time; keep it in a secure location.
- The bundle identifier must be globally unique on the App Store and must exactly match the identifier used in Firebase.
- One App Store Connect API key can authorize multiple apps, but revoking a compromised key requires creating a new one and updating HighLevel.
- The same Google account must be used throughout the Firebase steps to avoid permission errors.
09If something goes wrong
- The .p8 file cannot be found after download.. Revoke the existing key in App Store Connect under Users and Access > Keys, create a new key, and upload the new credentials in HighLevel.
- The chosen bundle identifier is already taken.. Modify the identifier by adding a company initial or region code, such as com.youragency.appname.na, until it is unique.
- Firebase validation fails due to mismatched bundle identifiers.. Ensure the bundle identifier entered in Firebase matches exactly the one registered in Apple Developer, then re upload the corrected plist file.
10How it connects to the rest of HighLevel
- Set up an Apple Developer account for your white label app Apple Developer enrollment
- Publish your iOS white label app in App Store Connect iOS publishing guide
- Link a Google PlayStore account to the Whitelabel Mobile App Customizer Google PlayStore linking