Skip to main content
:rocket: Getting Started & App Setup Updated

New App: Creating Your iOS App & Profiles

If you prefer not to grant Amego access to your Apple Developer account, you can still provide the necessary files so we can build and publish your app successfully.

Below are the files and steps required to ensure your iOS app can be signed, distributed, and send push notifications through OneSignal.

Files to Provide to Amego

Please provide the following files to support@amego.com along with the password details so our team can build and publish your app:

1. App Provisioning Profile
Used to sign your main iOS app.
.mobileprovision

2. OneSignal (Push) Provisioning Profile
Used for the OneSignal Notification Service Extension.
.mobileprovision

3. Distribution Certificate
Used to sign and distribute your app.
.p12 file + password

4. Apple Push Notification Auth Key
Used by OneSignal to send push notifications.
.p8 file + Key ID + Team ID

Apple Account Setup & Naming Conventions

Amego uses a consistent naming convention for all Apple app identifiers, profiles, and certificates. Please follow the exact format below when creating your entries.

Note: The {{AMEGO_APP_ID}} can be any text string you choose — usually a short version of your app or event name.

1. Create App Group

  1. Go to developer.apple.com/account/resources/identifiers
  2. Create a new App Group with this naming format:
group.com.amego.app{{AMEGO_APP_ID}}.onesignal

2. Create App Identifier (Main App)

  1. Go to developer.apple.com/account/resources/identifiers/add/bundleId
  2. Create a new App Identifier with this naming format:
com.amego.app{{AMEGO_APP_ID}}

Once created, open the new identifier and enable these capabilities:

  • App Groups → select the group you just created: group.com.amego.app{{AMEGO_APP_ID}}.onesignal
  • Associated Domains
  • Push Notifications

3. Create App Identifier for OneSignal Extension

  1. Go to developer.apple.com/account/resources/identifiers/add/bundleId
  2. Create a new App Identifier for the OneSignal extension:
com.amego.app{{AMEGO_APP_ID}}.OneSignalNotificationServiceExtension

Enable the following capabilities:

  • App Groups → select the same group: group.com.amego.app{{AMEGO_APP_ID}}.onesignal
  • Push Notifications

4. Create App in App Store Connect

  1. Go to appstoreconnect.apple.com/apps and click the + button and fill in the modal:
    • Platform: iOS
    • Bundle ID: com.amego.app{{AMEGO_APP_ID}}
    • SKU: Amego_{{AMEGO_APP_ID}} or any unique value you prefer

5. Create Apple Distribution Signing Certificate

  1. Go to developer.apple.com/account/resources/certificates/list
  2. Click the + button and select Apple Distribution under the Software section.
  3. Upload a Certificate Signing Request (CSR) from your Mac (Apple's CSR instructions are available during the creation process).
  4. Download the .cer file once created.

Export the .p12 File

  1. Double-click the .cer file to open it in Keychain Access.
  2. Locate your Apple Distribution certificate under My Certificates.
  3. Expand the item, right-click the private key, and select Export.
  4. Save as a .p12 file and set a password (you'll share this password securely with Amego).

6. Create Provisioning Profiles

(A) App Provisioning Profile

  1. Go to developer.apple.com/account/resources/profiles
  2. Click the + button.
  3. Select App Store under Distribution.
  4. Choose the App ID: com.amego.app{{AMEGO_APP_ID}}
  5. Select the Apple Distribution Certificate you just created.
  6. Name the profile clearly, such as: YourAppName_AppStore
  7. Download the .mobileprovision file.

(B) OneSignal Provisioning Profile

  1. Click the + button again to create another profile.
  2. Select App Store under Distribution.
  3. Choose the App ID: com.amego.app{{AMEGO_APP_ID}}.OneSignalNotificationServiceExtension
  4. Select the same Apple Distribution Certificate.
  5. Name the profile: YourAppName_OneSignal_AppStore
  6. Download the .mobileprovision file.

7. Generate Apple Push Notification Auth Key (.p8)

  1. Go to Certificates, Identifiers & Profiles → Keys → +
  2. Name the key: Amego Push Key
  3. Enable Apple Push Notifications service (APNs).
  4. Download the .p8 file (Apple only allows one-time download).
  5. Copy the following details for Amego: Key ID and Team ID (found on your Membership page).

Send Files to Amego

Please send the following securely to your Amego Customer Success contact:

  • YourAppName_AppStore.mobileprovision
  • YourAppName_OneSignal_AppStore.mobileprovision
  • AppleDistributionCertificate.p12 + password
  • AuthKey.p8 + Key ID + Team ID

For security, please do not email these directly — use a secure file-sharing link (such as Box, Dropbox, or Google Drive).

Comments

0 comments

Article is closed for comments.