Summary: This guide is for IT administrators whose organization prefers not to grant Speakap full Admin permissions on their Apple Developer account. It explains how to invite the Speakap team with restricted roles and how to manually set up the identifiers and app record needed to publish your branded iOS app.
Note: Steps 2 through 6 are optional. If you grant the access described in step 1, our mobile team can also do these for you.
Step 1: Invite Speakap with restricted roles
Instead of the Admin role, you can invite Speakap with a combination of restricted permissions that still allow us to manage your app builds.
- Log in to App Store Connect (https://appstoreconnect.apple.com/login).
- Select Users and Access > People and click the blue plus (+) sign.
- Enter the following details:
- First Name: Speakap
- Last Name: Development
- Email: mobile-development@speakap.nl
- In the Roles section, select App Manager.
- In the Additional Resources section, you must check the following boxes:
- Access to Certificates, Identifiers & Profiles
- Access to Cloud Managed Distribution Certificate
Step 2: Set up the iCloud Container
Because Speakap has restricted access, your account holder must manually create the iCloud container.
- Go to https://developer.apple.com/account and tap Identifiers.
- Click the plus (+) button next to Identifiers.
- Select iCloud Containers and click Continue.
- Fill in the following fields:
- Description: Must be preceded by "iCloud" (e.g., iCloud YourAppName).
- Identifier: Must use the prefix iCloud.com.speakap. followed by your unique app identifier (e.g., iCloud.com.speakap.yourappidentifier). Note: the identifier cannot contain whitespace.
- Click Continue and Register.
Step 3: Set up the App Group
- On the Identifiers screen, click the plus (+) button again.
- Select App Groups and click Continue.
- Fill in the following fields:
- Description: Your app name.
- Identifier: Must use the prefix group.com.speakap. followed by the same identifier used for the iCloud container.
- Click Continue and Register.
Step 4: Create App IDs
You must create two App IDs: one for the main app and one for the Share Extension.
Main App ID:
- Click the plus (+) button next to Identifiers and select App IDs.
- Select type App.
- Description: Enter your app name.
- Bundle ID: Select Explicit and enter com.speakap.yourappidentifier.
- Capabilities: Enable App Groups, Associated Domains, Data Protection (Complete Protection), iCloud (Include CloudKit support), and Push Notifications.
- Click Continue and Register.
- Find the new App ID in your list, click it, and Configure both the App Group and iCloud Container you created in the previous steps. Save your changes.
Share Extension App ID:
- Repeat the steps above but use the following details:
- Description: YourAppName Share Extension.
- Bundle ID: com.speakap.yourappidentifier.ShareExtension.
- Enable App Groups, Associated Domains, Data Protection, and iCloud.
- Configure the same App Group and iCloud Container as the main app. Save your changes.
Step 5: Generate the App Record
Finally, create the record in App Store Connect so Speakap can upload the builds.
- Go to https://appstoreconnect.apple.com/apps.
- Click the plus (+) button and select New App.
- Fill out the form:
- Platforms: iOS.
- Bundle ID: Select the Main App ID you just generated.
- SKU: Use the same string as your Bundle ID.
- User Access: Select Full Access (so the invited Speakap team can see it).
- Click Create.
Step 6: Limit Speakap's access to the specific app
If you want to make sure Speakap only sees this specific app:
- Go to Users and Access.
- Select the mobile-development@speakap.nl user.
- Under the Apps section, remove "All Apps" and specifically add only the new app you created.
Once these steps are done, you can continue by entering your details in the Whitelabel Portal following these guidelines.
Still stuck?
Email us at technicalimplementations@speakap.nl with your organization name, the step you are stuck on, and a screenshot of what you see, and we'll help you out.