Linking Your Apple App Store Account to the White-Label Mobile App Customizer

Overview

This guide details the steps required to link your Apple Developer account to the CRM's Mobile App Customizer. Completing this process authorizes the CRM to build, sign, and submit your white-label iOS app to the App Store on your behalf. You will configure three primary components: an App Store Connect API key, a unique bundle identifier, and Firebase configuration files. Finishing these steps automates future app updates and enables core features like push notifications.

Prerequisites: You must have an active Apple Developer Program account with Admin privileges before you begin.

How to Complete the Onboarding Flow

Step 1: Generate an App Store Connect API Key

This key grants the CRM permission to manage your app in App Store Connect.

1. Navigate to the App Store Connect website and go to the Users and Access section, then select Keys under the App Store Connect API heading.
2. Click the button to Generate API Key.
3. Provide a descriptive name for the key (e.g., "CRM Mobile App") and confirm the generation.
4. Immediately download the resulting .p8 private key file. Apple only allows you to download this file once, so store it securely.
5. From the key management page, copy the Key ID. Also, locate and copy your Issuer ID, which is displayed at the top of the page.
6. In your CRM's Mobile App Customizer, find the App Store Connection section. Upload the .p8 file and paste the Key ID and Issuer ID into the corresponding fields.

Note: A single API key can be used for multiple apps. If a key is compromised, you can revoke it in App Store Connect and generate a new one.

Step 2: Register a Bundle Identifier

The bundle identifier is a unique string that acts as your app's ID on the App Store and within Apple's ecosystem.

1. Within the Mobile App Customizer's setup wizard, locate the field for Package Name / Bundle Identifier.
2. Click the Register button. The system will validate your Apple account and display the associated development team.
3. Enter a unique reverse-DNS style identifier, such as com.yourcompany.appname. Use only lowercase letters, numbers, and periods.
4. The CRM will then register this identifier with your Apple Developer account. If the name is already taken, you will need to choose a different one.

This identifier must exactly match the one you use when configuring Firebase in the next step to prevent build errors.

Step 3: Configure Firebase

Firebase provides backend services like push notifications and analytics for your app.

1. Go to the Firebase Console and sign in with a Google account.
2. Create a new project or select an existing one.
3. Add an iOS app to the project and enter the bundle identifier you registered in Step 2.
4. Download the generated GoogleService-Info.plist configuration file.
5. Return to the Setup Firebase stage in the CRM's Mobile App Customizer. Upload the downloaded .plist file using the provided upload area.
6. The CRM will validate the file. Once confirmed, services like push notifications will be enabled for your app.

Frequently Asked Questions

Can I use one API key for multiple apps?

Yes, a single App Store Connect API key can authorize the CRM to manage multiple applications.

What if my desired bundle identifier is already taken?

You must choose a different, unique identifier. Try appending your company initials or a region code (e.g., com.youragency.appname.us).

I lost my .p8 file. What should I do?

You will need to revoke the old key in your App Store Connect account under Users and Access > Keys and then generate a new one. Upload the new key details to the CRM.

Can I change the Firebase project linked to my app later?

Yes, but you will need to generate new configuration files from the new Firebase project that use the same bundle identifier and upload them to the CRM.