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

# API-Schlüssel und Authentifizierung

> Erstelle einen API-Schlüssel und greife damit auf einen Teams-Workspace zu.

Jeder Endpunkt in dieser Referenz erfordert einen API-Schlüssel und **Teams Connect**. Nur Inhaber und Admins eines Workspaces können Schlüssel verwalten.

## Schlüssel erstellen

**1. API-Schlüssel öffnen**

Melde dich im [Tapify-Dashboard](https://tapify.app/login) an, wähle deinen Workspace und öffne **Einstellungen → API-Schlüssel**.

**2. Schlüssel erstellen und benennen**

Wähle **API-Schlüssel erstellen**, gib einen Namen wie `CRM sync` ein und wähle **Schlüssel erstellen**.

**3. Schlüssel kopieren**

Wähle **Kopieren und schließen** und bewahre den Schlüssel sicher auf. Er wird nur einmal vollständig angezeigt.

> [!WARNING]
>
> Jeder, der den Schlüssel besitzt, kann Mitglieder und Kontakte im Workspace auslesen, erstellen, ändern und löschen. Speichere ihn auf deinem Server. Verwende ihn niemals in Browsercode, einer mobilen App, einem öffentlichen Repository oder einer Nachricht an den Support.

## Anfrage authentifizieren

Sende deinen Schlüssel im `Authorization`-Header:

```bash theme={null}
curl https://tapify.app/api/v1/me \
  --header "Authorization: Bearer YOUR_API_KEY"
```

Tapify akzeptiert auch `X-API-Key: YOUR_API_KEY`. Verwende pro Anfrage eine Methode. Wenn du beide Header sendest, hat das Bearer-Token Vorrang.

Ein Schlüssel kann nicht zwischen Workspaces wechseln. Erstelle in jedem Workspace, den du anbinden möchtest, einen eigenen Schlüssel. Schlüssel gewähren vollen API-Zugriff auf den Workspace; eine Variante mit reinem Lesezugriff gibt es nicht.

## Schlüssel ersetzen oder löschen

Wenn du einen Schlüssel verloren hast oder ersetzen möchtest:

1. Erstelle einen neuen Schlüssel im selben Workspace.
2. Aktualisiere deine Anbindung und teste sie mit `/me`.
3. Lösche den alten Schlüssel unter **Einstellungen → API-Schlüssel**.

Gelöschte Schlüssel funktionieren sofort nicht mehr. Beim Löschen werden auch die damit registrierten Zapier-Abonnements entfernt. Verbinde die betroffenen Zaps erneut mit dem neuen Schlüssel.

## Häufige Fragen

> [accordion] Warum erhalte ich 401 Unauthorized?
>
> Prüfe, ob du den vollständigen Schlüssel gesendet hast und nicht nur seinen sichtbaren Anfang oder Namen. Entferne zusätzliche Leerzeichen und prüfe, ob der Schlüssel gelöscht wurde. Ein Tapify-Anmeldecode oder Sitzungstoken aus der App ersetzt keinen API-Schlüssel.

> [accordion] Warum erhalte ich 402 Payment Required?
>
> Der Workspace benötigt Teams Connect. Prüfe unter **Einstellungen → Abrechnung** den Tarif und Zahlungsstatus. Prüfe auch, ob die Testphase bereits abgelaufen ist. Core enthält keinen API-Zugriff.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.