Connect XCRunway with an App Store Connect API key

Before you start

You need an Apple Developer account and a project with Xcode Cloud already configured. XCRunway works with your existing workflows; create or edit them in Xcode or App Store Connect.

Connecting an account requires an annual XCRunway subscription. You can explore the app with sample data in Demo without a subscription or API key.

1. Choose an Individual or Team key

An Individual key uses your App Store Connect role and app access. It needs a Key ID and a private key file, with no Issuer ID.

A Team key uses its assigned role and also needs an Issuer ID. The Developer role is enough to browse and start builds in XCRunway.

2. Get your key from App Store Connect

For an Individual key, sign in to App Store Connect, open your username menu, and choose Edit Profile. In Individual API Key, generate a key and download it. Save its Key ID too. If you already have a key, use your saved file.

For a Team key, an Account Holder or Admin can generate one inUsers and Access → Integrations → Team Keys. Save the private key, Key ID, and Issuer ID.

Apple allows each private key to be downloaded only once. Store the.p8 file securely. If API access hasn’t been enabled, your Account Holder must request it first. See Apple’s API key instructionsfor permissions and key management.

3. Connect your account in XCRunway

1. Open account setup and select the key type that matches your API key.
2. Import your private key’s .p8 file, or paste its contents.
3. For a Team key, enter the Issuer ID from App Store Connect.
4. Enter the Key ID associated with that private key, then choose Connect.

Your private key stays in this device’s Keychain. It doesn’t sync or migrate to other devices, so repeat setup on each iPhone, iPad, or Mac you want to use. XCRunway doesn’t require a separate account.

4. Check your Xcode Cloud builds

Browse your project’s build history and open a build to inspect its status, issues, tests, logs, and artifacts. You can also start a workflow or rerun a build from XCRunway.

Working with more than one App Store Connect account? Add each account separately, then switch between them in the app.

If you can’t connect

• Check that the selected key type matches your Individual or Team key.
• Make sure the Key ID belongs to the private key you imported. Team keys also need the matching Issuer ID.
• Check whether the key has been revoked and whether your role has access to the project.
• If a project is missing, confirm that Xcode Cloud is configured for it in Xcode or App Store Connect.

Read the XCRunway FAQ for more on accounts and security, or contact us for help. Don’t include your private key in a support message.