# TestFlight

<div align="left"><img src="/files/lDXmXxizyifZu4lMnThJ" alt=""></div>

### Set up

#### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

#### Connect TestFlight

* Find the **TestFlight** integration module under the **Beta testing** section
* Click the **Connect** button
* Select an existing App Store Connect installation, or enter your ASC API key’s Key ID and Issuer ID, and upload the .p8 key file
* Click **Save**; you’ll be presented with a dialog in which to enter your [TestFlight settings](#testflight-settings)

{% hint style="info" %}
You can generate API keys within App Store Connect.

* You must be logged into App Store Connect with an **Admin** account to generate API keys.
* Runway requires an API key with the **App Manager** role.

:link: [**Apple - Creating API Keys for App Store Connect API**](https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api).
{% endhint %}

![Issuer ID, Key ID, and download link from the Users and Access section in App Store Connect](/files/4HmfttInHWir0w8PII2w)

### TestFlight settings

* Enter your TestFlight settings:
  * **Bundle ID** — Choose the bundle ID of the app you use for beta testing. You can choose the same bundle ID as your production app, or select an alternate one linked to this App Store Connect installation if you use a different app for beta testing.

{% hint style="success" %}
If you enable the '[Assign beta testing builds to default testing groups](/automations/types-of-automations.md#assign-beta-testing-builds-to-default-testing-groups)' automation, you can select default external beta groups to distribute builds to.
{% endhint %}

{% hint style="warning" %}
Beta builds distributed through TestFlight require approval from Apple before they become available to external testers. Note that all eligible builds will be immediately available to users in the App Store Connect Users group (these are considered ‘internal testers’ by Apple).

Beta builds can be manually submitted for approval via Runway, or you can enable the [Submit new builds for beta review](/automations/types-of-automations.md#submit-new-builds-for-beta-review) automation.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.runway.team/integrations/beta-testing/testflight.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.