App Store Connect Connection

The App Store Connect connection integrates your Apple developer account with OpsTower, giving agents the ability to list your iOS and macOS apps and query customer reviews with filtering and sorting. All operations are read-only.

Prerequisites

You need an Apple Developer account enrolled in the Apple Developer Program with access to App Store Connect. The Account Holder must enable API key access if it has not been enabled before.

Credentials Required

To set up an App Store Connect connection, you need three values:

• Issuer ID — a UUID displayed above the key table in App Store Connect
• Key ID — a 10-character alphanumeric identifier shown next to each key
• Private Key (.p8) — an ECDSA P-256 private key file downloaded when the key is created

How to Create an API Key

1. Sign in to App Store Connect.
2. Go to Users and Access > Integrations > App Store Connect API.
3. If this is your first time, the Account Holder must click Request Access first.
4. Select the Team Keys tab, then click Generate API Key.
5. Name it (e.g., “OpsTower Integration”) and select the Admin role (required for analytics access).
6. Click Generate, then immediately download the .p8 file. This file can only be downloaded once.
7. Copy the Issuer ID (displayed above the key table) and the Key ID (shown in the key row).
8. Open the downloaded .p8 file in a text editor, select all the contents (including the -----BEGIN PRIVATE KEY----- and -----END PRIVATE KEY----- lines).

Setup in OpsTower

1. Go to Connections > App Stores > Add Connection.
2. Select App Store Connect.
3. Paste your Issuer ID, Key ID, and the full contents of your .p8 private key.
4. Click Test Connection to verify the credentials.
5. Click Save.

What Agents Can Do

Once connected, agents have access to two tools:

• List Apps — list all apps in the account with name, bundle ID, and SKU
• Get Reviews — query customer reviews for a specific app, filterable by star rating (1-5) and territory (country code), sortable by date or rating, with summary statistics including average rating and rating distribution

Use Cases

• “What apps do I have in App Store Connect?”
• “Show me all 1-star reviews for my app from the last week”
• “What are users in the US saying about my app?”
• “What’s the average rating across all recent reviews?”
• “Are there common complaints in the latest reviews?”
• “Compare review sentiment between the US and UK markets”

Troubleshooting

• 401 Unauthorized — verify your Issuer ID, Key ID, and private key are correct. The .p8 file content must include the full PEM headers.
• 403 Forbidden — ensure the API key has at least the Admin role. Some endpoints require elevated permissions.
• “Private key must be in PEM format” — make sure you pasted the full .p8 file contents including the -----BEGIN PRIVATE KEY----- and -----END PRIVATE KEY----- lines.
• Rate limiting — App Store Connect allows approximately 3,600 requests per hour. Each tool call uses a single request.