<!-- AI agents: this is the Markdown version of an AppNorth documentation page. Index: https://www.appnorth.app/llms.txt -->

# App Store Connect

Connect your Apple team to AppNorth to import apps and use reviews, metadata and price localization. The connection belongs to the workspace organization and can serve its imported apps.

## Connect and import {#connect}

1. Open [Apps](/dashboard/apps) and the App Store Connect connection panel, or use the connection step during onboarding.
2. Provide the Issuer ID, Key ID and matching private `.p8` key. The key must have access to the apps and operations you intend to use.
3. Save the connection. AppNorth validates the key format and attempts to list apps from Apple before storing it.
4. Select the apps to import. Existing imports are recognized by their App Store Connect app ID.

Import creates AppNorth projects linked to the Apple app and bundle ID. If the selection exceeds the workspace's app allowance, the import is rejected. Connecting Apple does not install the native SDK; follow [Get started](/docs/get-started) for feedback and chat.

## Credentials and permissions {#credentials}

Only workspace owners and admins can manage the connection. The server checks the dashboard session and same-origin mutation before accepting a change.

The private key is sealed with AES-256-GCM and organization/connection-specific authenticated context. Dashboard responses expose the key identifiers, connection state and verification information, not the private key. Keep the `.p8` on the server; never place it in Swift code, app resources or a public repository.

A successful app-list check establishes access to that request. Later review, metadata or pricing operations can still fail if the key lacks the necessary Apple permissions or the app is not editable.

## Replace or disconnect {#disconnect}

Use the panel to replace the connection's credentials or disconnect it. Imported projects remain when the connection is removed, but no longer have a connected store credential. Check their store-dependent workflows after reconnecting.

## Connection errors {#errors}

| Code                        | Action                                                                                          |
| --------------------------- | ----------------------------------------------------------------------------------------------- |
| `INVALID_CREDENTIALS`       | Check the IDs and the matching P-256 private key                                                |
| `CREDENTIALS_REJECTED`      | Check whether Apple revoked the key or denied its access                                        |
| `CREDENTIALS_UNREADABLE`    | Ask the deployment operator to restore encryption-key access, or reconnect with the private key |
| `ENCRYPTION_NOT_CONFIGURED` | The deployment operator must configure credential encryption                                    |
| `STORE_UNAVAILABLE`         | Retry after the provider or connection recovers                                                 |
| `UNKNOWN_APPS`              | Reload the accessible app list and select again                                                 |

Demo mode does not save credentials or contact Apple.