Connect App Store Connect

Asomium talks to App Store Connect through the official ASC API. You’ll need a key with App Manager role (Admin works too, but we recommend the minimum required role).

Generate an API key

1. Sign in to App Store Connect.
2. Click Users and Access → Integrations → App Store Connect API.
3. Click the + to create a new key. Name it something like Asomium - <your machine name>.
4. Choose the App Manager access role.
5. Click Generate. Download the .p8 file — you can only download it once. Save it somewhere safe.

You’ll also need three values from the same page:

• Key ID — shown next to the key in the table
• Issuer ID — at the top of the Integrations page
• The .p8 file contents — paste from the downloaded file

Paste into Asomium

1. Open Asomium → Settings → App Store Connect.
2. Paste Key ID, Issuer ID, and the contents of the .p8 file into the three fields.
3. Click Test connection. Asomium will hit /v1/apps and confirm the credentials work.
4. Click Save. The credentials are persisted in your macOS Keychain, scoped to Asomium’s bundle ID.

How Asomium uses the API

Asomium uses the same endpoints as the ASC website:

• GET /v1/apps — fetch your app list
• GET /v1/apps/{id}/appStoreVersions — get version state
• GET /v1/appStoreVersionLocalizations — multi-locale metadata
• PATCH /v1/appStoreVersionLocalizations/{id} — write back edits
• POST /v1/reviewSubmissions + PATCH .../submit — submit for review

You can audit every call in Settings → Activity log — Asomium records request, response, and timestamp for every ASC interaction.

Rotating keys

Generate a new key in ASC, paste it into Asomium, click Test then Save. Once you’ve confirmed everything works, revoke the old key in ASC.