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

# iOS Credentials

> Add your Apple Developer credentials to Studio — App Store Connect API key and APNs auth key for builds and push notifications.

Two separate Apple credentials are required for iOS: one for building and signing, one for push notifications.

In Studio, go to **Store Setup → Credentials → iOS**.

## App Store Connect API Key

Used for code-signing builds and submitting to the App Store.

### Getting the key

1. Open [App Store Connect](https://appstoreconnect.apple.com) and go to **Users and Access → Integrations → App Store Connect API**.
2. Click **+** to create a new key. Give it a name (e.g. "Blockli Build") and set the role to **Developer** or **Admin**.
3. Note the **Issuer ID** shown at the top of the page.
4. Copy the **Key ID** shown next to your new key.
5. Click **Download API Key** — this downloads a `.p8` file. **You can only download it once.**

### Uploading to Studio

In Studio, paste or upload:

| Field             | Value                                            |
| ----------------- | ------------------------------------------------ |
| **Issuer ID**     | The UUID shown on the App Store Connect API page |
| **Key ID**        | The 10-character key ID                          |
| **API Key (.p8)** | The downloaded `.p8` file contents               |

## APNs Auth Key

Used to send push notifications to iOS devices via Apple Push Notification service.

### Getting the key

1. Open [Apple Developer](https://developer.apple.com/account) and go to **Certificates, Identifiers & Profiles → Keys**.
2. Click **+** to create a new key.
3. Give it a name (e.g. "Blockli APNs") and check **Apple Push Notifications service (APNs)**.
4. Click **Continue**, then **Register**.
5. Copy the **Key ID**.
6. Click **Download** — this downloads a `.p8` file. **You can only download it once.**

<Note>
  One APNs key works across all apps in the same Apple Developer account. If you have multiple Blockli apps, you can reuse the same APNs key.
</Note>

### Uploading to Studio

| Field                   | Value                              |
| ----------------------- | ---------------------------------- |
| **APNs Key ID**         | The 10-character key ID            |
| **APNs Auth Key (.p8)** | The downloaded `.p8` file contents |

## App identifier

Before triggering a build, ensure your iOS app identifier is registered in App Store Connect:

1. Go to **Certificates, Identifiers & Profiles → Identifiers**.
2. Click **+**, choose **App IDs**, and register your bundle ID (e.g. `com.yourcompany.yourapp`).
3. Enable **Push Notifications** capability on the identifier.

The bundle ID must exactly match the one you entered when creating the app in Studio.
