# Link your app

**Pre-requisites** 

* You have setup your App Store Connect API key. [Read more..](https://docs.appmachine.com/share-your-app/apple-app-store/app-store-connect-api-keys)
* You have created an app record in App Store Connect. [Read more..](https://docs.appmachine.com/share-your-app/apple-app-store/new-app-record-in-app-store-connect)

### Linking the App Store Connect app record to your AppMachine app

The following steps assume that you've successfully uploaded your App Store Connect API key. In case you're not on the screen displayed in step 1, please follow the steps in [this article](https://docs.appmachine.com/share-your-app/apple-app-store/app-store-connect-api-keys).

1. After uploading your App Store Connect API key, the wizard will show a list of app records retrieved from your Apple developer account.\
   \
   \&#xNAN;***\* Note:** The App Store Connect API key that you've uploaded is linked to the account on which the key is created, and therefor has the same access rights as the account. Apps to which the key does not have access will not be displayed in this list.*<br>

   <figure><img src="https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80117036389/original/bWB1B4RH7jFm66CqXRqUyUudMgkmA1whhw.png?1656356494" alt=""><figcaption></figcaption></figure>
2. Depending on your situation you need choose between:&#x20;
   * **New app:** \
     If you don't have any apps on your developer account yet, click the Create new App Bundle Identifier button.<br>

     <figure><img src="https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80120280319/original/UkZEbhK4eFgPB85AzLZ93iIInzTpJu5oXw.png?1657200510" alt=""><figcaption></figcaption></figure>
   * **Existing app:** \
     If a bundle identifier for your app already exists within your developer license, then you can link the existing app by clicking the bundle identifier from the app list.

When you've linked your app, continue the process by following the steps in [this article](https://docs.appmachine.com/share-your-app/apple-app-store/new-app-record-in-app-store-connect).<br>


---

# 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.appmachine.com/share-your-app/apple-app-store/link-your-app.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.