> ## 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](https://docs.anny.co/make-com.md) 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 im Katalog unter **Apps & Integrationen** in 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 (**Account** → **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 **1. Community-Node installieren** 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/). **2. Zugangsdaten anlegen** 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. **3. Trigger oder Aktion hinzufügen** 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. **4. Workflow aktivieren** 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. | > [!TIP] > > 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 Apps & Integrationen:** Der Node wird in n8n installiert, nicht über den Katalog 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](https://docs.anny.co/make-com.md) 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 > [!WARNING] > > 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 **Account** → **Einstellungen** im Tab **API & Webhooks** (Rotieren oder Löschen). ## FAQ > **Ist das ein offizieller anny-Node?** > > 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. > **Wann nutze ich n8n, wann Make.com?** > > 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](https://docs.anny.co/make-com.md). > **Welche Ereignisse kann der Trigger empfangen?** > > 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**. > **Brauche ich Programmierkenntnisse?** > > Nein. Du baust den Workflow in n8n zusammen. Ein Grundverständnis von Webhooks hilft beim Fehlersuchen. ## Troubleshooting > **Der Trigger startet nicht** > > 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. > **OAuth-Login schlägt fehl** > > 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. > **API-Aktionen schlagen fehl** > > 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 Kachel im Katalog unter anny Account → Apps & Integrationen. 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: `bookings.confirmed`, `bookings.canceled`, subscriptions.*, timeslots.*, community-accounts.*, call-sessions.* (die gibt es in anny-Webhooks, siehe Make-Artikel). Die Ereignisauswahl im Admin listet `bookings.confirmed` und `bookings.canceled` noch nicht; die API akzeptiert sie. > > **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 Seitenleiste Account → 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.