---
title: "API-Schlüssel erzeugen und widerrufen"
description: "API-Schlüssel auf der Konto-Seite anlegen (Owner, Admins, Plattform-Admins), sicher aufbewahren, Ablauf, Protokoll und Widerruf"
---

API-Schlüssel verwaltest du auf deiner **Konto-Seite** (Benutzermenü → **Account**, Abschnitt **API-Schlüssel**). Den Abschnitt sehen nur Konten, die mindestens eine Community als Owner oder Admin verwalten, und Plattform-Admins.

## Schlüssel erzeugen

1. Öffne die Konto-Seite und scrolle zu **API-Schlüssel**.
2. **Name des Schlüssels** – wofür er ist, z. B. „Mitglieder-Abgleich CRM“. Der Name erscheint später im Protokoll der Community bei jeder Änderung über diesen Schlüssel.
3. **Zugriff** – **Nur lesen** oder **Lesen und schreiben** (siehe [Überblick](/rest-api/ueberblick#lesen-oder-lesen-und-schreiben)).
4. **Gültig bis (optional)** – letzter Tag, an dem der Schlüssel gilt (bis Tagesende in deiner Zeitzone). Leer = unbefristet.
5. Bestätige mit deinem **Passwort**. Ist die Zwei-Faktor-Anmeldung aktiv, gibst du zusätzlich den **Code aus der App** ein. Konten ohne Passwort (Anmeldung mit Google) bestätigen mit einer frischen Anmeldung: abmelden, wieder anmelden und innerhalb von 10 Minuten erzeugen.
6. Klicke auf **Schlüssel erzeugen**.

Danach erscheint der Schlüssel **genau einmal**, z. B. `qt_Ab12Cd34_…` mit insgesamt 55 Zeichen. Kopiere ihn sofort in einen Passwort-Manager oder in die Konfiguration deines Programms. QuickTribe speichert nur einen Fingerabdruck – den Schlüssel selbst kann niemand mehr anzeigen, auch kein Plattform-Admin.

<Note>
Ein API-Schlüssel umgeht die Anmeldung im Browser und die Zwei-Faktor-Abfrage. Deshalb verlangt QuickTribe beim Erzeugen Passwort und 2FA-Code. Behandle den Schlüssel wie ein Passwort: nicht in Quellcode einchecken, nicht per E-Mail oder Chat weitergeben, nur über HTTPS verwenden.
</Note>

Nach dem Erzeugen bekommst du eine E-Mail **„Neuer API-Schlüssel erstellt“** mit Name, Präfix, Zugriff und Ablauf (ohne den Schlüssel selbst). Kommt diese Mail unerwartet, widerrufe den Schlüssel sofort und ändere dein Passwort. Im [Protokoll des Plattform-Admins](/handbuch/plattform-admin/protokoll) stehen Erzeugen und Widerrufen jedes Schlüssels.

## Liste und Widerruf

Die Liste zeigt je Schlüssel Name, Präfix (die ersten Zeichen zur Wiedererkennung), Zugriff, Erstellungsdatum, die letzte Nutzung (auf wenige Minuten genau) und das Ablaufdatum.

**Widerrufen** löscht den Schlüssel; Programme, die ihn verwenden, bekommen ab sofort `401`. Einen widerrufenen Schlüssel kann man nicht wiederherstellen – erzeuge bei Bedarf einen neuen.

Je Konto sind bis zu **10** Schlüssel möglich. Nutze für jedes Programm einen eigenen Schlüssel: Dann siehst du im Protokoll, welches System eine Änderung gemacht hat, und kannst einzelne Zugänge widerrufen.

## Wann ein Schlüssel nicht (mehr) wirkt

| Situation | Antwort |
| --- | --- |
| Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen | `401` |
| Konto gelöscht oder E-Mail-Adresse nicht bestätigt | `401` |
| Konto ist in dieser Community nicht mehr Owner oder Admin (bzw. nicht mehr Plattform-Admin) | `403` |
| Community vom Plattform-Admin gesperrt (außer für Plattform-Admins) | `403` |
| Schlüssel „nur lesen“ bei einem schreibenden Aufruf | `403` |

Auch wer keine Admin-Rolle mehr hat, sieht seine vorhandenen Schlüssel auf der Konto-Seite weiter und kann sie widerrufen, aber keine neuen erzeugen.

## Datenschutz

Im [Datenexport](/handbuch/mitglieder/konto-datenschutz#meine-daten-exportieren) stehen deine API-Schlüssel mit Name, Präfix, Zugriff und Zeitpunkten (nie der Schlüssel oder sein Fingerabdruck). Beim [Löschen des Kontos](/handbuch/mitglieder/konto-datenschutz#konto-löschen) werden alle Schlüssel entfernt.
