Apps

App platform Manifest reference Authentication API for apps Connections between apps UI extensions Notifications Design guidelines Review and marketplace Privacy and obligations Troubleshooting and FAQ

App platform

Troubleshooting and FAQ

Common errors with the manifest, tokens, webhooks and extensions, and how to fix them

Manifest and versions

Installing and enabling

Tokens

Webhooks

Extensions

Review and updates

Getting help

Write to [email protected]. Include your app's client ID and, if it concerns a specific installation, its installation_id and the event ID (evt_…). Never send secrets or tokens.

Privacy and obligations

Data processing, member consent, deletion duty and data minimization for app providers

TypeScript SDK

The official SDK for apps and integrations, with a typed API client, token handling, and webhook and extension verification

Troubleshooting and FAQ

Manifest and versions

„Scope ist für Apps gesperrt“ (scope is blocked for apps)

„Ereignis … braucht den Scope …“ (event … needs the scope …)

„… braucht den Scope … in tenantScopes“ (… needs the scope … in tenantScopes) for an extension

„… erlaubt keine Darstellung als iframe“ (… does not allow rendering as an iframe)

„userScopes ohne Installationsart user oder Nutzerverknüpfung“ (userScopes without installation type user or user linking)

„Nur https-URLs sind erlaubt“ (only https URLs are allowed) or „Interne Adressen sind nicht erlaubt“ (internal addresses are not allowed)

„… braucht eine Beschriftung (label)“ (… needs a label) or „Beschriftung von …: höchstens 24 Zeichen“ (label of …: at most 24 characters)

„icon gibt es nur bei booking_plan.action, sidebar.action und nav.page“ (icon only exists for booking_plan.action, sidebar.action and nav.page)

„nav.page braucht ein Symbol (icon)“ (nav.page needs an icon)

„requires gibt es nur bei nav.page“ or „requires: Recht … ist nicht unter permissions deklariert“ (requires only on nav.page, or the right is not declared)

„permissions gibt es nur bei Vereins-Installationen“ (permissions only for club installations)

„height gibt es nur bei iframe-Erweiterungen“ or „height: mindestens 120 Pixel“ (height only for iframes, or at least 120 pixels)

„… darf nur einmal vorkommen“ (… may only appear once)

I want to correct a version

Installing and enabling

My app does not appear under „App hinzufügen“ (Add app)

„Der Anbieter hat noch keinen Auftragsverarbeitungsvertrag hinterlegt“ (the provider has not provided a data processing agreement yet)

„Stelle die App zuerst auf privat“ (set the app to private first)

„Die App ist noch installiert und kann nicht gelöscht werden“ (the app is still installed and cannot be deleted)

„Sandbox-Limit erreicht“ (sandbox limit reached)

I cannot invite a colleague: „Kein Konto mit dieser E-Mail“ (no account with this email)

Tokens

Installation token: 401 invalid_client

API: 401 UNAUTHORIZED with a fresh token

API: 400 VALIDATION „Die App ist in mehreren Vereinen verbunden“ (the app is connected in several clubs)

API: 403 FORBIDDEN

Refresh: invalid_grant, even though the token was new

Refresh: temporarily_unavailable

Members see „Dein Verein hat diese App nicht freigegeben“ (your club has not allowed this app)

Webhooks

No events arrive

Error messages in the delivery log

Signature verification fails

An event arrives twice

Extensions

„Dieser Inhalt ist gerade nicht verfügbar.“ (this content is currently unavailable)

The extension does not appear at all

My court badges, column values or booking hints don't show

My iframe page loads, but its scripts and styles fail with 403 under next dev

The height of my iframe stays at the minimum

My iframe shows the wrong font, or fonts fail with a CORS error

My app's page is missing from the navigation

My iframe receives no messages, or its messages have no effect

Review and updates

„Zur Prüfung einreichen“ (submit for review) is grayed out

Clubs do not get my new version

I changed the listing, but clubs still see the old one

Getting help

On this page