Learning & Support


iOS: Setup key-based authentication for Apple Push Notifications

Twixl Support Team Updated: - Created :

    In the past we used Certificate based authentication for sending Push Notifications to iOS devices. The procedure to create these certificates is rather complex and can cause frustrations. That's the reason why we recommend using key-based authentication.

    1. Setup your App ID

    To enable Push Notifications in your iOS Application, you still need to adapt the App ID.

    1. Navigate to (developer.apple.com > Account > Certificates, Identifiers & Profiles > Identifiers > App ID)
    2. If you want to edit an existing App ID, select Configure, otherwise select New Apple ID
    3. After you entered a description for this App ID and the Bundle Identifier (use the same reverse-DNS name as in the Twixl Distribution Platform) you can configure it.


    It's very important that you use the same Bundle Identifier as on the Twixl Platform (reverse-DNS name). This is a requirement in order to be able to send Push Notifications from within the Twixl Platform to your iOS devices.

    2. Activate Push Notifications for the App ID

    1. When in the App ID detail window, you'll notice a list of all App Services.
    2. Enable for Apple Push Notifications.


    No need to create a Development or Production SSL Certificate! That part is not necessary when setting up a Key based authentication.

    3. How to create the authentication key

    1. Navigate to https://developer.apple.com/account/ios/authkey/ . (developer.apple.com > Account > Certificates, Identifiers & Profiles > Keys)
    2. Top on the + button to add a new key.
    3. Give the key a name and enable the service called Apple Push Notifications (APNs).
    4. Click on Continue. You will then be asked to confirm your key configuration.
    5. Click on Confirm to create the key.
    6. Select Download in the next screen to download the .p8 file to your local machine.
    7. After you've created the key, click on Keys again in the left column, select the key you have just created and write down the value for Key ID.
    8. Then, navigate to https://developer.apple.com/account and click on Membership in the left column, write down the Team ID.

    4. Configure the Push Notification settings on the Twixl Platform.

    1. On the Twixl Distribution Platform, navigate to your app.
    2. Select Push Notifications in the App Menu.
    3. Select Key-based Authentication for the Authentication Mode.
      1. Upload the .p8 file
      2. Insert the Key ID you wrote down
      3. Insert the Team ID you wrote down.

    Was this article helpful?

    1 out of 1 found this helpful