---
title: "Setup: Linking Frisbii Media with the Apple API (v2)"
slug: "link-apple-api-v2"
description: "Set up an iOS app connection by retrieving App Store Connect credentials, configuring the Frisbii Media webhook, and adding app data in the Merchant Backend."
updated: 2026-01-16T12:58:05Z
published: 2026-01-16T12:58:05Z
canonical: "help.frisbii.com/link-apple-api-v2"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.frisbii.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup: Linking Frisbii Media with the Apple API (v2)

## Preliminary Remarks

In order to connect the apps (Storekit v2) with the [Frisbii Media Merchant Backend](/help/de-de/203-entwicklung/483-mobile-apps), the following information is required, which is available in App Store Connect:

- Name of the app (bundle ID)
- App-specific key (shared secret)
- Issuer ID
- Key ID
- Setting up the webhook

**Name of the app**

The unique **bundle ID** is understood to be the name of the app. The bundle ID must match the ID used during app development (within X-Code). **Attention:** Please do not use the information from the free text field "Name" in the App Store Connect backend.

**App-specific key (shared secret)**

The app-specific key (shared secret) is required to establish and authenticate a connection between the Apple API and the Frisbii Media API. The Shared Secret is a unique code to retrieve receipts for subscriptions with automatic renewal for a selected app. If several apps are to be used, a separate shared secret must be used for each app.

> [!TIP]
> **Note**: Only the account owner and administrator roles can display and create a shared secret.

---

## App Store Connect

The following steps must be carried out to obtain the necessary information from the [App Store Connect backend](https://appstoreconnect.apple.com/).

**1. Name of the app (bundle ID)**

- Open the desired app in the main menu item Apps.
- Click on General > App information in the navigation bar on the left-hand side.
- The **Bundle ID** is located in the General information section (structure of the Bundle ID: com.companyname.appname)

**2. Shared Secret** The shared secret can also be found in the main menu item Apps > desired app > General > App information.

- In the App-specific key (Shared Secret) section, click on the **Manage** link.
- Create a new shared secret or copy the existing shared secret.

**3. Issuer ID and Key ID**

- Open the main menu item Users and access rights.
- Open the Integration tab .
- By default, the App Store Connect API sub-item > Team key opens.
- The **Issuer ID** can now be copied here.
- The **key ID** can be found in the table in the Key ID column.

**4. Setting up the Frisbii Media webhook** The webhook setup can also be found in the main menu item Apps > desired app > General > App information.

- Click on the Set up URL link in the App Store server notifications section.
- Enter the **URL of the** **Frisbii Media webhook** in the Production Server URL field: - Stage System: https://callbacks.frisbii-media-stage.com/callbacks/v1.0/appStore/{companyId}/appleappstore - Live System: https://callbacks.frisbii-media.com/callbacks/v1.0/appStore/{companyId}/appleappstore The Frisbii Media CompanyId can be viewed in the URL in the Merchant Backend in the desired client: [Where can I find the CompanyID?](/frisbii-media/docs/wo-finde-ich-die-companyid)
- Version selection: Version 2

---

## Creating Connection in the Merchant Backend

The data previously copied from the App Store Connect can be stored in the Frisbii Media Merchant Backend in the next step.

- Open the desired client.
- In the main menu item **Settings**, open the sub-item **Development**.
- Open the menu item **Mobile Apps.**
- Click on **Add iOS App** in the action bar.
- Store the data from the App Store Connect.