---
title: "Setup: Connecting Frisbii Media with the Apple API (v1)"
slug: "link-apple-api-v1"
description: "Learn how to connect App Store Connect to Frisbii Media using the app bundle ID, shared secret, webhook, and Merchant Backend iOS app settings."
updated: 2026-01-16T12:59:37Z
published: 2026-01-16T12:59:37Z
canonical: "help.frisbii.com/link-apple-api-v1"
---

> ## 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: Connecting Frisbii Media with the Apple API (v1)

## Preliminary Remarks

The App Store Connect backend provides extensive information on apps that have been created. Only the following information is required for the connection with Frisbii Media:

- the name of the app
- the app-specific key (shared secret)
- 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 can be found under General information (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 link **Manage** .
- Create a new shared secret or copy the existing shared secret.

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

- In the App Store server notifications section, click on the link **Set up URL** .
- 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 my 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 Merchant Backend in the next step.

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