AppFromShop

Guide · Launch on the stores

Set up push notifications for iPhone

Create an Apple push key in your Apple Developer account and add it in Launch, so notifications reach your iPhone app. Android works automatically.

  • About 2 minutes
  • 4 steps

You will need

  • The Apple Developer account your iPhone app belongs to: the one connected in Launch → Apple. You need the Account Holder or Admin role there to create keys.
  • Your app's iOS bundle id set in Launch → App identity. The key is checked against it.
  • Owner access to your AppFromShop workspace. Members can see whether iPhone push is ready, not change the key.

What Launch asks for

Each box in Launch, named as the form names it, where the value comes from and what it looks like.

Push key file (.p8)

Downloaded from Certificates, Identifiers & Profiles → Keys right after you create the key. Apple lets you download it only once.

A small text file named AuthKey_ followed by the Key ID, ending in .p8, starting with -----BEGIN PRIVATE KEY-----.

AuthKey_ABC123XYZ9.p8
Key ID

Next to the key in Certificates, Identifiers & Profiles → Keys, and in the file name.

10 letters and digits.

ABC123XYZ9
Team ID

Apple Developer → Account → Membership details. Launch fills it in when your App Store Connect key is connected.

10 letters and digits.

A1B2C3D4E5
  1. Why iPhone push needs one step from you

    Notifications reach phones through Apple and Google. Google's side is set up automatically for every Android build, so Android push works as soon as the app is installed.

    Apple only delivers notifications to an iPhone app with a push key from the Apple Developer account that owns the app, and Apple doesn't let any app or service create that key for you. So it's created once, by hand, in your Apple account. One key works for every app in that account, and it never expires.

  2. Step 1: Create the push key in your Apple Developer account

    Sign in at developer.apple.com and open Certificates, Identifiers & Profiles → Keys. Click the + button next to Keys.

    Under Key Name, enter a name you'll recognise, for example AppFromShop Push. Tick Apple Push Notification service (APNs), then click Configure next to it.

    On the configuration page choose the environment Sandbox & Production and the key type Team Scoped (All Topics), so the one key works for every app in your account, in TestFlight and in the App Store. Click Continue, then Register (or Confirm).

    Click Download to save the key file (AuthKey_<Key ID>.p8). Apple lets you download it only once, so keep the file somewhere safe. If you lose it, revoke the key and create a new one.

  3. Step 2: Note the Key ID and your Team ID

    The Key ID is shown on the key's page and in the Keys list, and it's also in the file name: AuthKey_ABC123XYZ9.p8 has the Key ID ABC123XYZ9.

    Your Team ID is under Account → Membership details. If your App Store Connect key is already connected in Launch → Apple, AppFromShop fills in the Team ID for you, so you only need the Key ID.

  4. Step 3: Add the key in AppFromShop

    In your app's dashboard open Launch, then the Apple step, and find iPhone push notifications. Click Upload the .p8 file (or paste the file's contents), check the Key ID (and the Team ID, if your Apple account isn't connected yet), and click Check and save.

    AppFromShop checks the key with Apple without notifying anyone, stores it encrypted, and attaches it to your iPhone app. The card then shows Active, with your Key ID and Team ID. No new app build is needed.

    What Launch asks for

    Push key file (.p8)

    Downloaded from Certificates, Identifiers & Profiles → Keys right after you create the key. Apple lets you download it only once.

    AuthKey_ABC123XYZ9.p8
    Key ID

    Next to the key in Certificates, Identifiers & Profiles → Keys, and in the file name.

    ABC123XYZ9
    Team ID

    Apple Developer → Account → Membership details. Launch fills it in when your App Store Connect key is connected.

    A1B2C3D4E5
  5. Step 4: Send a test notification

    Open Push, write a short message and send it. Phones that allowed notifications receive it within seconds. The campaign's results say how many were delivered and, for any that weren't, why in plain words.

    Notifications only reach people who installed the app and allowed notifications on their phone. A phone where the app was uninstalled is skipped automatically.

If something is refused

The message the dashboard shows, and what fixes it.

“That isn't an Apple push key” or “That file isn't a valid Apple push key (.p8)”

The box doesn't contain a .p8 key. Upload the AuthKey_….p8 file you downloaded from Apple, or open it in a text editor and paste all of it, including the BEGIN and END lines. Keys for App Store Connect or Sign in with Apple are a different kind of key.

“Apple didn't accept this key with Key ID … and Team ID …”

The Key ID or Team ID doesn't match the key, or the key was revoked. Check the Key ID in Certificates, Identifiers & Profiles → Keys and the Team ID in Membership details (step 2). If the key was revoked, create a new one (step 1).

“This key is set up for Apple's Sandbox only”

The key was created with the environment set to Sandbox, which only reaches apps built for development. Apps from TestFlight and the App Store use Production. Create a new key with Sandbox & Production (step 1) and add that one.

“This key works, but it belongs to a different Apple Developer account than the app”

The key comes from another Apple account than the one that owns your app's bundle id, or it is a Topic Specific key for other apps. Sign in to the Apple account connected in Launch → Apple and create a Team Scoped (All Topics) key there.

“We couldn't reach Apple to check the key just now”

Apple didn't answer in time. Nothing was saved; try again in a minute.

“Apple accepted the key, but attaching it to your app didn't work just now”

The key is fine and stored; the last step, attaching it to your app, didn't go through. Click Check and save again in a minute. If it keeps happening, contact support and our team will attach it.

A campaign says “iPhone push key missing or invalid”

Those iPhones couldn't be reached because no working push key is attached to the app. Add the key (step 3), then send the campaign again. Android phones in the same campaign were not affected.

Done? Go to Launch

Open your app in the dashboard, choose Launch and paste what you collected. Launch verifies it with the store before anything is stored.

Sources (console paths checked against the official documentation): Apple: Communicate with APNs using authentication tokens · Apple: Create a private key · Apple: Locate your Team ID · Apple: Handling notification responses from APNs · Expo: Sending notifications (error codes)

See your app on your phone today

Connect your store, pick a template and preview it on your phone. Free for 14 days.

Start your free trial