> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n mit anny verbinden
> Automatisiere Buchungen, Kund:innen und Rechnungen mit dem offiziellen anny-Node in n8n.
[n8n](https://n8n.io) ist eine Workflow-Plattform, in der du Automatisierungen visuell baust. anny stellt dafür den Community-Node [`n8n-nodes-anny`](https://github.com/anny-co/anny-n8n) bereit. Anders als bei [Make.com](/make-com) brauchst du Webhooks und API-Aufrufe nicht von Hand zu verdrahten: Der Node verwaltet Anmeldung und Webhook-Abonnements selbst.
Mit n8n kannst du in anny:
* auf Ereignisse reagieren, zum Beispiel eine neue Buchung, einen Check-in oder eine neue Rechnung
* Buchungen, Kund:innen, Bestellungen, Rechnungen, Abos, Ressourcen und Services lesen oder ändern
* Verfügbarkeiten abfragen und beliebige anny-API-Aufrufe aus einem Workflow heraus ausführen
Ideal für Teams, die anny mit CRM, Tabellen, Chat oder Buchhaltung verbinden wollen, ohne eigene Integrationen zu programmieren.
## Typische Anwendungsfälle
| Anwendungsfall | Beschreibung |
| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Neue Buchung ins CRM | **Jede neue Buchung erzeugt automatisch einen Datensatz.** Der **Anny Trigger** startet bei `bookings.created`, der **Anny**-Node lädt Kund:in und Buchung nach. |
| Check-in in einem anderen System | **Der Check-in in anny stößt den nächsten Schritt an.** Zum Beispiel eine Nachricht im Chat oder ein Eintrag in deiner Tabelle. |
| Rechnung weiterverarbeiten | **Fertiggestellte Rechnungen landen dort, wo du buchst.** Der Trigger **Invoice Finalized** liefert das Ereignis an deinen Workflow. |
## Wie die n8n-Verbindung funktioniert
n8n erscheint nicht in der Integrationen-Liste von anny. Du installierst den Node in deiner n8n-Instanz (Cloud oder selbst gehostet) und hinterlegst Zugangsdaten:
* **OAuth2** (Standard): Du wählst die Region (**anny.co** oder **anny.eu**) und schließt den Login im Browser ab. n8n erhält damit Zugriff im Namen deines Admin-Kontos, inklusive Webhook-Abonnements.
* **Access Token**: Du hinterlegst einen **Personal Access Token** aus anny (**Einstellungen** → Tab **API & Webhooks**).
Der **Anny Trigger** legt in anny automatisch ein Webhook-Abonnement an und löscht es, wenn du den Trigger entfernst. Der **Anny**-Node spricht die anny API für Aktionen an.
Widerrufst du den Zugang, stoppen die Workflows: Löschst du die Credentials in n8n oder rotierst du den Token in anny, schlagen API-Aufrufe fehl. Entfernst du den Trigger, verschwindet das zugehörige Webhook-Abonnement.
So laufen die Daten:
| Richtung | Baustein | Beispiele |
| :-------------------- | :--------------- | :----------------------------------------------------------------- |
| anny → n8n (Auslöser) | **Anny Trigger** | Buchung erstellt, Check-in, Rechnung finalisiert, Kund:in erstellt |
| n8n → anny (Aktionen) | **Anny**-Node | Buchung lesen, stornieren, einchecken; Kund:in anlegen; API Call |
## n8n verbinden
### Voraussetzungen
Bevor du n8n verbindest, stelle sicher, dass du Folgendes hast:
* Ein n8n-Konto (n8n Cloud oder selbst gehostete Instanz), in dem du Community-Nodes installieren darfst
* Ein anny-Admin-Konto für die gewählte Region
* Für Access Token zusätzlich Zugriff auf den Tab **API & Webhooks**
### Verbindung einrichten
Installiere in n8n das Paket `n8n-nodes-anny` als Community-Node. Die Schritte stehen in der [n8n-Dokumentation zu Community-Nodes](https://docs.n8n.io/integrations/community-nodes/installation/).
Lege in n8n die Credential **Anny OAuth2 API** an, wähle die **Region** (**anny.co** oder **anny.eu**) und schließe den OAuth-Login ab. Alternativ nutzt du **Anny Access Token API** mit einem Personal Access Token aus anny.
Für Ereignisse fügst du den Node **Anny Trigger** hinzu und wählst die **Events**, zum Beispiel **Booking Created**. Für Aktionen fügst du den Node **Anny** hinzu und wählst Ressource und Operation, zum Beispiel Booking → Get.
Speichere und aktiviere den Workflow. Der Trigger erzeugt dann das Webhook-Abonnement in anny.
Sobald der Workflow aktiv ist, startet n8n bei jedem ausgewählten Ereignis automatisch.
### Einstellungen & Optionen
| Einstellung | Beschreibung |
| :------------------------------- | :------------------------------------------------------------------------------------------------------------- |
| Authentication | **OAuth2** oder **Access Token** am jeweiligen Node. |
| Region | **anny.co (default)** oder **anny.eu (Gov-Cloud)**. Muss zu deinem anny-Account passen. |
| Events (Trigger) | Die Ereignisse, die den Workflow starten, zum Beispiel Booking Created, Booking Checked In, Invoice Finalized. |
| Resource / Operation (Anny-Node) | Booking, Customer, Order, Invoice, Plan Subscription, Resource, Service, Availability oder API Call. |
| Simplify | Liefert bei Get/Get All eine vereinfachte Antwort statt des rohen JSON:API-Dokuments. |
Für Endpunkte, die der Node nicht abbildet, nutze die Operation **API Call** gegen `/api/v1/…`.
## Einschränkungen
Die n8n-Anbindung unterstützt nicht:
* **Eintrag unter Integrationen:** Der Node wird in n8n installiert, nicht über die Integrationen-Liste in anny.
* **Alle Webhook-Ereignisse:** Der Trigger deckt Buchungen, Kund:innen, Bestellungen und Rechnungen ab. Abos, Termine und Community-Mitglieder richtest du bei Bedarf über ein manuelles Webhook-Abonnement wie bei [Make.com](/make-com) ein.
* **Feingranulare Token-Rechte:** Ein Personal Access Token erhält den Zugriff, den auch ein Admin über die API hat. Einzelne Berechtigungen sind im UI noch nicht wählbar.
## Verbindung trennen
Löschst du die Credentials in n8n oder rotierst du den Personal Access Token in anny, schlagen bestehende Workflows fehl. Entfernst du einen **Anny Trigger**, löscht n8n das zugehörige Webhook-Abonnement in anny.
Credentials verwaltest du in n8n. Den Personal Access Token findest du in anny unter **Einstellungen** im Tab **API & Webhooks** (Rotieren oder Löschen).
## FAQ
Ja. anny pflegt den Community-Node im GitHub-Repository [anny-co/anny-n8n](https://github.com/anny-co/anny-n8n) (npm-Paket `n8n-nodes-anny`). Es ist kein generisches HTTP-Modul, sondern ein eigener Node mit Trigger und Aktionen.
n8n, wenn du den fertigen anny-Node mit OAuth und automatischen Webhooks willst. Make.com, wenn du bereits Make nutzt: Dort verbindest du anny über generische Webhooks und HTTP, siehe [make.com](/make-com).
Buchungen (erstellt, aktualisiert, gestartet, beendet, eingecheckt, ausgecheckt, gelöscht), Kund:innen, Bestellungen und Rechnungen (inklusive finalisiert). Die Bezeichnungen im Node sind englisch, zum Beispiel **Booking Created**.
Nein. Du baust den Workflow in n8n zusammen. Ein Grundverständnis von Webhooks hilft beim Fehlersuchen.
## Troubleshooting
Der Workflow ist möglicherweise nicht aktiv, die Region stimmt nicht, oder die gewählten Events passen nicht. Aktiviere den Workflow und prüfe in anny unter **API & Webhooks**, ob ein Abonnement mit dem Namen `n8n Trigger - Workflow …` existiert.
Meist ist die falsche Region gewählt. **anny.co** und **anny.eu** sind getrennte Umgebungen. Wähle die Region, in der dein Account liegt, und schließe den Login erneut ab.
Die Credentials sind abgelaufen, der Token wurde rotiert, oder der Access Token hat keinen Zugriff mehr. Lege die Credential in n8n neu an oder erstelle unter **API & Webhooks** einen neuen Token.
> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** n8n ist KEINE Integration in der anny Integrationen-Liste. Offizieller Community-Node: GitHub anny-co/anny-n8n, npm `n8n-nodes-anny`, Nodes **Anny** (`anny`) und **Anny Trigger** (`annyTrigger`). Make.com hat KEINEN vergleichbaren branded Connector.
>
> **Auth:** Credentials **Anny OAuth2 API** (Region co/eu/staging/local, Grant authorizationCode, Scopes `user:read b.* b.webhook-subscriptions:*`, preAuthentication holt `organizationId` via `/api/v1/user?include=active_organization`) oder **Anny Access Token API** (PAT Bearer). UI-Regionen für Kund:innen: anny.co und anny.eu (Gov-Cloud). Staging/Local nicht im sichtbaren Artikel.
>
> **Trigger:** legt POST `/api/v1/webhook-subscriptions` an, Name `n8n Trigger - Workflow {id}`; löscht beim Entfernen. Events im Node: bookings.created/updated/started/ended/checked-in/checked-out/deleted, customers.*, orders.*, invoices.created/updated/deleted/finalized. NICHT im Trigger: subscriptions.*, timeslots.*, community-accounts.*, call-sessions.* (die gibt es in anny-Webhooks, siehe Make-Artikel).
>
> **Aktionen:** Availability, Booking (get/list/cancel/check-in/check-out), Customer (CRUD+list), Order/Invoice/Plan Subscription/Resource/Service (get/list), API Call für beliebige `/api/*`.
>
> **UI-Pfade anny:** Personal Access Token nur unter Einstellungen → API & Webhooks. Kein Integrationen-Toggle.
>
> **Beziehungen:** Make.com-Artikel `/make-com` (generische Webhooks+HTTP). Changelog 2025-12-16 erwähnt n8n Cloud. API-Doku darf Make nicht als native Connector behaupten.