Zum Hauptinhalt springen
Die Seite API keys mit zwei Schlüsseln, die nur mit Name und Präfix aufgeführt sind, einer davon als Sandbox gekennzeichnet, mit Erstellungs- und letztem Verwendungsdatum, Revoke-Aktionen und der Schaltfläche Create key
Mit einem API-Schlüssel können Ihre Skripte, No-Code-Tools und Backend-Dienste die Flowella REST API für Ihre Organisation aufrufen. Diese Seite zeigt, wie Sie Schlüssel erstellen, verwenden, ersetzen und widerrufen.

​
Bevor Sie beginnen

  • Sie benötigen die Rolle Owner oder Admin. Andere Rollen sehen API keys im Menü, aber die Liste wird für sie nicht geladen. Siehe Team und Rollen.
  • Legen Sie fest, wo Sie den Schlüssel speichern, zum Beispiel in einem Secrets Manager oder im Anmeldedatenspeicher Ihres Tools. Flowella zeigt den vollständigen Schlüssel nur einmal an.
Sie entwickeln eine App, die andere Flowella-Kunden installieren? Verwenden Sie statt eines API-Schlüssels eine OAuth-App. Siehe Eine Partner-App mit OAuth registrieren.

​
Einen API-Schlüssel erstellen

1

API keys öffnen

Gehen Sie zu Settings und wählen Sie in der Gruppe Developer die Option API keys.
2

Einen neuen Schlüssel beginnen

Wählen Sie Create key. Der Dialog Create API key öffnet sich.
3

Den Schlüssel benennen

Geben Sie unter Name etwas ein, das Ihnen sagt, wo der Schlüssel verwendet wird, zum Beispiel n8n production. Namen können bis zu 120 Zeichen lang sein. Flowella zeigt den Namen nur in dieser Liste an; er wird nicht mit API-Anfragen gesendet.
4

Live- oder Sandbox-Schlüssel wählen

Lassen Sie Sandbox key für einen Live-Schlüssel deaktiviert. Aktivieren Sie es für einen Schlüssel, der nie etwas an WhatsApp sendet. Siehe Sandbox-Schlüssel.
5

Den Schlüssel erstellen und kopieren

Wählen Sie Create. Der Dialog Save your API key zeigt den vollständigen Schlüssel an. Wählen Sie Copy, speichern Sie den Schlüssel und wählen Sie dann Done.
Flowella zeigt den vollständigen Schlüssel nur einmal an und kann ihn nicht erneut anzeigen. Wenn Sie ihn verlieren, widerrufen Sie den Schlüssel und erstellen Sie einen neuen. Behandeln Sie Schlüssel wie Passwörter: Committen Sie sie nie in die Versionsverwaltung und fügen Sie sie nie in Chats oder geteilte Dokumente ein.

​
Was ein Schlüssel kann

Sie können einen Schlüssel in der App nicht auf bestimmte Scopes beschränken. Wenn eine Integration eingeschränkteren Zugriff haben soll, registrieren Sie eine OAuth-App nur mit den Scopes, die sie benötigt.

​
Einen Schlüssel verwenden

Senden Sie den Schlüssel als Bearer-Token im Header Authorization jeder Anfrage. Um zu prüfen, ob ein Schlüssel funktioniert, rufen Sie den Ping-Endpunkt auf:
Eine 200-Antwort mit "ok": true bedeutet, dass der Schlüssel gültig ist. Wählen Sie oben auf dem Bildschirm View API docs, um die interaktive API-Referenz zu öffnen. Dort können Sie den Schlüssel einfügen und Anfragen ausprobieren.

​
Sandbox-Schlüssel

Mit einem Sandbox-Schlüssel können Sie eine Integration testen, ohne etwas an WhatsApp zu senden. Anfragen mit einem Sandbox-Schlüssel verhalten sich so:
  • POST /v1/messages speichert die Nachricht in Flowella und gibt "sandbox": true mit metaMessageId gleich null zurück. Nichts erreicht WhatsApp.
  • Beim Einreichen einer Vorlage wird diese sofort genehmigt oder abgelehnt, wenn der Vorlagenname reject_ enthält. Meta sieht sie nie.
  • Testsendungen von Vorlagen werden übersprungen.
Ein Sandbox-Schlüssel stoppt keine Bulk-Sendungen über POST /v1/templates/send. Diese Nachrichten werden tatsächlich gesendet. Um Bulk-Sendungen sicher zu testen, aktivieren Sie stattdessen die organisationsweite API sandbox im Developer Hub. Solange sie aktiv ist, werden auch Bulk-Sendungen aus der App übersprungen.
Sandbox-Schlüssel arbeiten mit Ihrer echten Organisation. Kontakte, Konversationen und Nachrichten, die sie erstellen, werden wie alle anderen gespeichert und erscheinen in der App. Sandbox-Schlüssel zeigen in der Liste neben ihrem Namen ein Badge Sandbox.

​
Die Liste der API-Schlüssel

Welche Aufrufe ein Schlüssel kürzlich gemacht hat, sehen Sie unter Recent API requests im Developer Hub.

​
Einen Schlüssel widerrufen

  1. Wählen Sie in der Liste in der Zeile des Schlüssels Revoke.
  2. Bestätigen Sie die Abfrage Revoke this API key? It will stop working immediately.
Ab dann schlagen Anfragen mit diesem Schlüssel mit 401 und der Meldung Invalid or expired API key fehl. Die Zeile bleibt mit einem Badge Revoked in der Liste. Ein Widerruf lässt sich nicht rückgängig machen: Erstellen Sie einen neuen Schlüssel, wenn Sie wieder Zugriff benötigen.

​
Einen Schlüssel ersetzen

Es gibt keine Rotationsschaltfläche. So ersetzen Sie einen Schlüssel ohne Ausfallzeit:
  1. Erstellen Sie einen neuen Schlüssel mit einem eindeutigen Namen, zum Beispiel n8n production 2026.
  2. Stellen Sie Ihre Integration auf den neuen Schlüssel um.
  3. Prüfen Sie, ob sich der Wert Last used des neuen Schlüssels ändert.
  4. Widerrufen Sie den alten Schlüssel.

​
Fehlerbehebung

Nur Owners und Admins können API-Schlüssel anzeigen und verwalten. Bitten Sie einen Owner oder Admin, den Schlüssel für Sie zu erstellen. Rollen lassen sich in der App nicht ändern: siehe Die Rolle einer Person ändern.
Prüfen Sie, ob der Header genau Authorization: Bearer gefolgt vom vollständigen Schlüssel lautet, ohne Leerzeichen oder Zeilenumbrüche im Schlüssel. Die Meldung Invalid or expired API key bedeutet, dass der Schlüssel widerrufen oder falsch eingegeben wurde. Missing bearer token bedeutet, dass der Header nicht angekommen ist: Manche HTTP-Clients verwerfen ihn, wenn sie einer Weiterleitung folgen, rufen Sie daher https://api.flowella.io/v1 direkt auf.
Widerrufen Sie ihn sofort, erstellen Sie dann einen Ersatz und aktualisieren Sie Ihre Integration. Prüfen Sie Recent API requests im Developer Hub auf Aufrufe, die Sie nicht kennen.

​
Verwandt

API-Einführung

Authentifizierung, Scopes, Ratenlimits und Fehler.

Developer Hub

Letzte API-Anfragen, die API-Sandbox und Schnellstarts.

Entwickler-Apps

OAuth verwenden, wenn andere Organisationen Ihre App installieren.

Webhooks

Ereignisse empfangen, statt die API abzufragen.
Zuletzt geändert am 24. Oktober 2026