> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Entwickler-Changelog: API, Webhooks, OAuth und MCP > Änderungen an REST API, Webhooks, OAuth-Apps und MCP-Server von Flowella, mit markierten Breaking Changes und dem, was Sie anpassen müssen. Änderungen, die Integrationen auf Basis der Flowella REST API, Webhooks, OAuth-Apps und des Flowella-MCP-Servers betreffen, die neuesten zuerst. Einträge mit dem Tag **Breaking** erfordern eine Änderung auf Ihrer Seite, und jeder nennt, was Sie anpassen müssen. Änderungen an der Flowella-App finden Sie im [Changelog](https://knowledge.flowella.io/de/changelog.md). Die aktuelle API-Version ist `2026-08-11`. [Mehr erfahren: Versionierung](https://knowledge.flowella.io/de/api-reference/introduction.md#versioning) **6. November 2026** v2.8.0 ## Flow-Lebenszyklus * `GET /v1/flows/{id}` gibt den Status des Flows bei Meta (`metaStatus`), seine Screens, Felder und die Absendeaktion zurück. * `POST /v1/flows/{id}/publish?dry_run=true` prüft einen Flow, ohne ihn zu veröffentlichen. * `POST /v1/flows/{id}/deprecate` setzt einen Flow bei Meta außer Betrieb. Meta kann das nicht rückgängig machen. Flowella blockiert es, solange Vorlagen den Flow noch verwenden, außer Sie senden `force`. * `DELETE /v1/flows/{id}` gibt `409` `HUBSPOT_FLOW_MANAGED` für einen Flow zurück, der aus einem HubSpot-Formular erstellt wurde, und `409` `FLOW_REFERENCED_BY_TEMPLATES`, solange ein Vorlagenentwurf den Flow noch verwendet. Das Löschen eines Flows löscht ihn nie bei Meta: Setzen Sie ihn zuerst außer Betrieb (deprecate), um ihn dort stillzulegen. Das Veröffentlichen eines außer Betrieb gesetzten Flows gibt `409` `FLOW_DEPRECATED` zurück. * Wenn Sie eine Vorlage erstellen, kann eine Flow-Schaltfläche mit `flowellaFlowId` auf einen Flowella-Flow statt auf eine Meta-Flow-ID verweisen. * Flows, die Sie über die API erstellen, werden mit dem Einstiegsscreen `MAIN_FORM` veröffentlicht. Früher veröffentlichte Flows funktionieren weiter. Veröffentlichen Sie sie erneut, bevor Sie sie mit `flowellaFlowId` verwenden. ## Webhooks * Neues Ereignis `flow.status_updated`, wenn sich der Status eines Flows bei Meta ändert, zum Beispiel wenn er außer Betrieb gesetzt wird. Abonnieren Sie es unter **Settings** → **Webhooks**. [Ereignistypen](https://knowledge.flowella.io/de/api-reference/webhooks.md#ereignistypen) ## Zugangsdaten * `GET /v1/ping` gibt zurück, wie Sie angemeldet sind, welche Scopes Sie haben und bei Apps die Client-ID. [Zugangsdaten prüfen](https://knowledge.flowella.io/de/api-reference/introduction.md#check-your-credentials) * Wiederholte idempotente Antworten enthalten den Header `Idempotent-Replayed: true`. [Idempotenz](https://knowledge.flowella.io/de/api-reference/introduction.md#idempotency) ## MCP-Server * KI-Assistenten können sich per Anmeldung mit dem Flowella-MCP-Server verbinden, ohne API-Schlüssel. Die Person wählt eine Organisation und klickt auf dem Zustimmungsbildschirm von Flowella auf **Allow access**. Verbindungen von Mitgliedern, die nicht Owner oder Admin sind, sind schreibgeschützt. [Developer Apps](https://knowledge.flowella.io/de/settings/developer-apps.md) * **Installed apps** heißt jetzt **AI assistants** und hat eine Spalte **Last token**. [Installierte Apps prüfen und widerrufen](https://knowledge.flowella.io/de/settings/developer-apps.md#installierte-apps-prüfen-und-widerrufen) **2. November 2026** v2.7.0 * **Flowella-MCP-Server.** KI-Assistenten, die das Model Context Protocol unterstützen, können Ihre Kanäle, Vorlagen und Flows lesen. Der Server ist schreibgeschützt und verwendet einen API-Schlüssel der Organisation. [API-Schlüssel](https://knowledge.flowella.io/de/settings/api-keys.md) * `GET /v1/flows/{id}` akzeptiert die Flowella-Formular-ID. Das Bearbeiten des Schemas eines Flows, der aus einem HubSpot-Formular erstellt wurde, gibt `409` zurück: Nehmen Sie die Änderung in HubSpot vor und synchronisieren Sie erneut. [Flowella REST API](https://knowledge.flowella.io/de/api-reference/introduction.md) * In Flowella erstellte Flows können jede Einsendung an einen Ihrer Webhook-Endpunkte senden, festgelegt im Tab **Settings** des Flows. [Webhooks](https://knowledge.flowella.io/de/settings/webhooks.md) * Das Registrieren einer Developer App mit einer ungültigen Redirect-URI gibt einen verständlichen Fehler zurück. [Eine App registrieren](https://knowledge.flowella.io/de/settings/developer-apps.md#eine-app-registrieren) **16. Oktober 2026** v2.6.5 ## Breaking Changes * **`API-Version` akzeptiert nur `2026-08-11`.** Jeder andere Wert gibt `400` zurück. Lassen Sie den Header weg, oder senden Sie `2026-08-11`. [Versionierung](https://knowledge.flowella.io/de/api-reference/introduction.md#versioning) * **Webhook-Endpunkte brauchen eine öffentliche HTTPS-URL.** Private, Loopback- und Cloud-Metadaten-Adressen werden nicht akzeptiert. Prüfen Sie jeden Endpunkt, bevor Sie aktualisieren. [Einen Webhook-Endpunkt hinzufügen](https://knowledge.flowella.io/de/settings/webhooks.md#einen-webhook-endpunkt-hinzufügen) * **OAuth-Apps.** Prüfen Sie diese Anforderungen, bevor Sie eine App aktualisieren, die auf Flowella OAuth aufbaut: * Anfragen ohne Scope erhalten nur Lesezugriff, und unbekannte Scopes werden abgelehnt. * Die Endpunkte für Token, Introspect und Revoke erfordern eine Client-Authentifizierung. * Die Autorisierungsanfrage erfordert `state`. * Client-Credentials-Grants geben kein Refresh-Token zurück. * Das Widerrufen eines Tokens widerruft nur die Token-Familie dieses Tokens. [Developer Apps](https://knowledge.flowella.io/de/settings/developer-apps.md) ## API * Fehlerantworten enthalten innerhalb von `error` eine `requestId`, die Sie dem Support nennen können. [Fehler](https://knowledge.flowella.io/de/api-reference/introduction.md#errors) * Das Erstellen eines Kontakts gibt `201` zurück, das Aktualisieren `200`. Eine doppelte `externalId` gibt `409` zurück, ein gelöschter Kontakt `404`. ## Webhooks * Neue Ereignisse `contact.created`, `contact.updated` und `contact.deleted`. [Ereignistypen](https://knowledge.flowella.io/de/api-reference/webhooks.md#ereignistypen) * Geben Sie jedem Endpunkt mit **Name (optional)** einen Namen. Der Name erscheint in der Liste über der URL. * 24 Stunden lang nach dem Rotieren eines Signatur-Secrets signiert Flowella jede Zustellung zusätzlich mit dem alten Secret und sendet diese Signatur in `X-Flowella-Signature-Previous`, sodass Sie das Secret wechseln können, ohne Ereignisse zu verlieren. [Signatur-Secret rotieren](https://knowledge.flowella.io/de/api-reference/webhooks.md#signatur-secret-rotieren) * Ein erneut zugestelltes Ereignis behält seine ursprüngliche Ereignis-ID und seinen Zeitstempel. Zustellungsdatensätze in der API enthalten die Korrelations-ID, die Antwort-Header und den Zeitpunkt des nächsten Versuchs. [Ereignisse deduplizieren](https://knowledge.flowella.io/de/api-reference/webhooks.md#ereignisse-deduplizieren) * Owner der Organisation erhalten eine einzige Benachrichtigung, wenn Flowella einen fehlerhaften Endpunkt pausiert. [Wiederholungsversuche und Wartezeiten](https://knowledge.flowella.io/de/settings/webhooks.md#wiederholungsversuche-und-wartezeiten) **13. Oktober 2026** v2.6.0 * **Verwenden Sie `https://api.flowella.io`.** Anfragen an `https://api.flowella.io/v1/...` geben JSON zurück. Alte URLs unter `https://app.flowella.io/api/v1/...`, einschließlich des OpenAPI-Dokuments, leiten dauerhaft auf den API-Host weiter. Aktualisieren Sie Ihre Basis-URL, damit Sie sich nicht auf die Weiterleitung verlassen. [Basis-URL](https://knowledge.flowella.io/de/api-reference/introduction.md#base-url) * Der erste Server im OpenAPI-Dokument ist `https://api.flowella.io`, sodass importierte Collections die richtige Basis-URL aufrufen. [OpenAPI-Spezifikation](https://knowledge.flowella.io/de/api-reference/introduction.md#openapi-spec) * Die API lehnt ungültige Vorlagenkomponenten und Vorlagen, die die Einreichungslimits von Meta überschreiten, ab, bevor sie Meta erreichen. * Sie können Karussell-Vorlagen über die API erstellen und senden. Wenn Sie für eine Karte keine Medien übergeben, verwendet Flowella das genehmigte Beispiel dieser Karte. [Karussell-Vorlagen](https://knowledge.flowella.io/de/app/template-reference.md#karussell-vorlagen) * Fallback-Werte für Vorlagenvariablen gelten für Versände über die API. [Fallback-Werte](https://knowledge.flowella.io/de/app/template-variables.md#fallback-values) * Der **Developer hub** enthält vollständige Anleitungen und eine Postman-Collection. [Developer hub](https://knowledge.flowella.io/de/settings/developer-hub.md) **21. September 2026** * Wiederholte Versände derselben Vorlage über die API gehen schneller hinaus. * Wenn Meta einen Aufruf zur Vorlagenverwaltung drosselt, meldet Flowella das als Ratenlimit, sodass Ihre Wiederholungsversuche richtig zurückfahren. [Ratenlimits](https://knowledge.flowella.io/de/api-reference/introduction.md#rate-limits) **26. August 2026** * **`POST /v1/templates/send` gibt `202` zurück.** Flowella nimmt die Anfrage an, gibt sofort eine Job-ID zurück und stellt die Nachrichten im Hintergrund zu, wobei vorübergehende WhatsApp-Fehler erneut versucht werden. Wenn Ihre Integration auf eine Antwort `200` prüft, passen Sie sie so an, dass sie `202` mit `"status": "accepted"` erwartet. Verfolgen Sie die Zustellung im Tab **Statistics** der Vorlage. [Massenversand von Vorlagen](https://knowledge.flowella.io/de/api-reference/introduction.md#bulk-template-sends) * **`Idempotency-Key`.** Senden Sie einen Header `Idempotency-Key` mit `POST /v1/templates/send`, und Flowella erkennt Wiederholungen derselben Anfrage sieben Tage lang und gibt die ursprüngliche Job-ID zurück, statt erneut zu senden. [Idempotenz](https://knowledge.flowella.io/de/api-reference/introduction.md#idempotency) **2. August 2026** * REST v1 ist dokumentiert und wird auf dem eigenen API-Host unter `/v1/...` bereitgestellt. [Flowella REST API](https://knowledge.flowella.io/de/api-reference/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.