📘 Webhook einrichten & OAuth2-Zugriff zu fincrm in n8n

Diese Anleitung baut auf den Grundlagen der Webhook-Nutzung in fincrm auf.
👉 Lies hier zuerst die allgemeine Einführung zu fincrm Webhooks, falls du neu im Thema bist.

✅ Voraussetzungen

Ein aktiver n8n-Account (Self-hosted oder Cloud)
Zugriff auf dein fincrm-Konto mit Adminrechten
Eine registrierte fincrm API-App (für Client ID/Secret)
Die Redirect-URL aus n8n ist in fincrm hinterlegt

🧩 Ziel des Workflows

🔔 Immer informiert sein, wenn ein neues Vorhaben erstellt wird (Webhook purpose.created) – und die Daten direkt weiterverarbeiten können.

🔧 Schritt 1: Webhook in n8n einrichten

Öffne n8n und erstelle einen neuen Workflow
Füge einen Node vom Typ Webhook hinzu
Konfiguriere den Webhook wie folgt:

Feld	Wert
HTTP Method	`POST`
Path	Wert beibehalten
Authentication	`None`
Respond	`Immediately`

🔗 Die Webhook-URL erscheint direkt im Node, auch ohne den Workflow zu aktivieren.
Beispiel: https://n8n.deine-domain.de/webhook/fincrm/webhook/purpose-created

🔗 Schritt 2: Webhook in fincrm erstellen

Gehe in fincrm zu Einstellungen > Webhooks
Klicke auf „Webhook erstellen“
Wähle als Ereignis: purpose.created
Trage die generierte n8n Webhook URL ein, die du eben kopiert hast
(z. B. https://n8n.deine-domain.de/webhook/fincrm/webhook/purpose-created)
Speichern - fertig!

✅ Ab sofort sendet fincrm bei jedem neuen Vorhaben eine Nachricht an deinen n8n-Workflow.

🔐 Schritt 3: OAuth2 Verbindung zu fincrm in n8n einrichten

Damit n8n über die fincrm API Daten abrufen kann (z. B. Details zum Vorhaben), musst du eine OAuth2-Verbindung konfigurieren.
Dazu legst du in n8n ein neues Credential an und verknüpfst es mit deiner fincrm-App.

🧭 Vorbereitung: fincrm App-Zugangsdaten bereitlegen

Du benötigst:

Client ID
Client Secret
Die Redirect-URL, die n8n generiert

🔑 Diese Daten bekommst du in deinem fincrm-Entwicklerkonto unter Einstellungen > API-Apps.

🧩 In n8n: Neues OAuth2-Credential anlegen

Öffne n8n und gehe zu Credentials > New Credential
Wähle Typ: OAuth2 API
Benenne das Credential, z. B. fincrm OAuth2
Trage folgende Werte ein:

Feld	Wert
Auth URL	`https://api.fincrm.de/oauth/authorize`
Access Token URL	`https://api.fincrm.de/oauth/token`
Client ID	(deine fincrm App-Client-ID)
Client Secret	(dein Secret)
Scope	(leer lassen oder z. B. `read:purposes` falls notwendig)
Authentication	`Header`
Token Type	`Bearer`
Redirect URL	Wird von n8n vorgegeben → bei fincrm in der App registrieren

🔁 Redirect-URL in fincrm hinterlegen

In n8n wird dir eine Redirect-URL angezeigt (z. B. https://n8n.deine-domain.de/rest/oauth2-credential/callback).
Kopiere diese URL.
Gehe zu deiner API-App in fincrm und trage die Redirect-URL unter Redirect URIs ein.
Speichern.

⚠️ Ohne korrekte Redirect-URL schlägt die Verbindung fehl.

🔄 Verbindung testen

Klicke in n8n bei deinem Credential auf Connect OAuth2 Account
Es öffnet sich ein neues Fenster mit dem fincrm-Login
Nach erfolgreicher Authentifizierung ist dein Credential einsatzbereit

✅ Fertig!

Du kannst das OAuth2-Credential jetzt in jedem HTTP-Request-Node verwenden, um auf geschützte Endpunkte in fincrm zuzugreifen.

💡 Beispiel: Purpose-Daten abrufen

GET https://api.fincrm.de/v1/purposes/

Verwende dein OAuth2-Credential im HTTP-Node
Die Antwort enthält alle Infos zum Vorhaben

✅ Schritt 4: Teste den Webhook

Stelle sicher, dass dein Workflow aktiviert ist
Erstelle in fincrm testweise ein neues Vorhaben
Gehe zurück zu n8n → Du solltest im Webhook-Node die Daten sehen
(z. B. ID, Name, Status des Vorhabens)

🧠 Nächste Schritte

Rufe mit der Purpose-ID zusätzliche Daten ab: z. B. Antragsteller oder Objektdetails.
Versende automatisch E-Mails oder Slack-Nachrichten.
Baue Folgeprozesse – siehe Willkommensmail mit Outlook.

📄 Beispiel-Workflow (n8n JSON)

Hier findest du den kompletten Workflow als JSON-Datei zum Hochladen in dein n8n:

{
  "nodes": [
    {
      "parameters": {
        "path": "fincrm/webhook/purpose-created",
        "responseMode": "onReceived",
        "options": {}
      },
      "id": "Webhook1",
      "name": "Webhook - purpose.created",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1,
      "position": [300, 200]
    }
  ],
  "connections": {}
}

📥 Alternativ: Download als .json Datei (Optionaler Link in HubSpot einfügbar)

💡 Tipps

Du kannst auch weitere Events in fincrm nutzen, z. B.:

purpose.stage_changed

customer_area.self_disclosure_submitted

offer.created

📘 Webhook einrichten & OAuth2-Zugriff zu fincrm in n8n – Schritt für Schritt