Troubleshooting

This page lists common errors and known issues encountered while integrating Apple App Store Connect with Zluri, and instructions on how to fix them.

If your issue isn’t mentioned here, feel free to submit a ticket or contact us directly at [email protected].

---

APP-101: The Private KeyId, IssuerId, or ApiKey used to connect the integration is invalid or expired

When does this error occur?

• While connecting Apple App Store Connect to Zluri with invalid or expired credentials (Private KeyId, IssuerId, or ApiKey).

How to resolve:

• Ensure you are using the correct and valid credentials:

  1. Log in to your App Store Connect account.
  2. Go to Users and Access → Integrations tab.
  3. Select App Store Connect API in the left column.
  4. Make sure the Team Keys tab is selected.
  5. Click Generate API Key or the Add (+) button.
  6. Enter a name for the key (for your reference).
  7. Under Access, select the appropriate role for the key.
  8. Click Generate.
  9. Download the private key and securely store it. (The private key is available for download only once.)
  10. Use the Key ID, Issuer ID, and the downloaded private key (ApiKey) when connecting the integration in Zluri.

---

APP-102: The user trying to connect the integration does not have sufficient permissions to access calls

When does this error occur?

• When the user or API key used does not have the required permissions to access the necessary endpoints in App Store Connect.

How to resolve:

• Modify the user’s permissions or assign the correct role to the API key:
  • Ensure the API key has the required role (e.g., Admin) to access the endpoints needed by Zluri.
  • If permissions have been modified or revoked after connecting, restore the necessary permissions and reconnect the integration.

---

Additional Notes

• Secure your private keys as you would other sensitive credentials. If you suspect a private key is compromised, immediately revoke it in App Store Connect.
• App Store Connect API keys are unique to the App Store Connect API and cannot be used for other Apple services.
• Team keys provide access to all apps, while individual keys are limited to the apps and permissions of the associated user.
• Always copy and paste credentials directly from App Store Connect to avoid typos or missing characters.

---

If your issue is not listed here, please contact Zluri at [email protected] with the error details for further assistance.