> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS credentials (Apple)

> How to create the key on Apple’s site and paste the info into the Notifique dashboard.

<Tip>
  Apple requires an **official badge** to send alerts on iPhone. You create it on Apple’s site and paste the details in Notifique, like handing the doorman’s key to whoever rings the bell.
</Tip>

## In a few words

1. Have an **Apple Developer account** (paid, yearly)
2. Register the app and create a **notification key**
3. Note four pieces of info and paste them under **⚙️ Settings → iOS**

## What you’ll paste in Notifique

| In Notifique   | Where to find it on Apple                                |
| -------------- | -------------------------------------------------------- |
| **Key ID**     | After creating the key, 10-character code                |
| **Team ID**    | **Membership** menu, your team code                      |
| **Bundle ID**  | App “registration name” (e.g. `com.yourcompany.app`)     |
| **.p8 key**    | File you download when creating the key (one-time only!) |
| **Production** | On for published apps; off only for internal testing     |

<Note>
  **Bundle ID** must match on Apple’s site, Xcode, and Notifique, like the app’s ID on iPhone.
</Note>

## Step 1: Apple Developer account

1. Go to [developer.apple.com](https://developer.apple.com)
2. Sign in with your Apple ID
3. If needed, enroll in the **Apple Developer Program** (yearly fee)
4. Wait for Apple’s approval

## Step 2: Note your Team ID

1. In the portal, open **Membership**
2. Copy your **Team ID**, 10 characters (e.g. `AB12CD34EF`)

Save it, you’ll paste it in Notifique.

## Step 3: Register the app with Apple

1. Go to **Certificates, Identifiers & Profiles**
2. **Identifiers** → **+**
3. Choose **App IDs** → Continue
4. Type **App** → Continue
5. Give a name (e.g. “My Store App”)
6. Under **Bundle ID**, choose **Explicit** and type e.g. `com.yourcompany.app`
7. Check **Push Notifications**
8. Register

## Step 4: Create the notification key

1. Same portal: **Keys** → **+**
2. Key name (e.g. “Notifique alerts”)
3. Check **Apple Push Notifications service (APNs)**
4. Continue → Register
5. **Download the `.p8` file now**. Apple won’t let you download again
6. Note the **Key ID** on screen

<Warning>
  Lost the `.p8`? Create a new key on Apple and update Notifique.
</Warning>

## Step 5: Adjust the app in Xcode (your developer)

Ask whoever maintains the iPhone app to:

1. Open the project in Xcode
2. Confirm **Bundle Identifier** matches step 3
3. Add **Push Notifications**
4. Add **Background Modes** → check **Remote notifications**

Test on a **real iPhone**, simulator barely works for push.

## Step 6: Paste into Notifique

1. Open [app.notifique.dev](https://app.notifique.dev) → **Push** → your app
2. Click **⚙️**
3. Scroll to **iOS**
4. Fill Key ID, Team ID, and Bundle ID
5. Open the `.p8` in a text editor and paste **everything**, including `BEGIN` and `END` lines
6. **Production**: leave on for App Store or TestFlight; off only for dev testing
7. **Save changes**

## Step 7: Test

1. Push App screen → **iOS** tab → copy the code
2. Run on a real iPhone and accept “Allow notifications”
3. Send a test alert from the dashboard

## Something went wrong?

| What happened         | What to check                                                  |
| --------------------- | -------------------------------------------------------------- |
| Bundle not configured | Empty or mismatched Bundle ID vs Xcode                         |
| Alert doesn’t arrive  | Real iPhone; notifications allowed; correct Production setting |
| Key rejected          | Paste full `.p8`; correct Key ID and Team ID                   |

## Next steps

* [Add code to the iPhone app](/en/push-api/integracao/ios)
* [All guides](/en/push-api/integracao/index)