Webhooks

Externe Systeme anbinden und Daten in Echtzeit in n8n empfangen.

Was ein Webhook ist

Ein Webhook ist eine URL, die bei einem Event POST (oder GET) bekommt. n8n startet dann den Workflow mit dem Request-Body als Daten.

Setup in n8n

  1. Webhook-Node als Trigger hinzufügen
  2. Methode wählen (meist POST)
  3. Path setzen (oder generieren lassen)
  4. Test URL vs. Production URL beachten
  5. Workflow aktivieren, sonst antwortet nur die Test-URL im Listen-Modus

Testen

curl -X POST "https://DEINE-INSTANZ/webhook-test/mein-pfad" \
  -H "Content-Type: application/json" \
  -d '{"name":"Anna","email":"anna@example.com"}'

Im Editor siehst du die Items unter Input/Output.

Sicherheit

  • Geheimnisse im Path oder Header prüfen (X-Webhook-Secret)
  • Nur HTTPS in Produktion
  • Bei öffentlichen Endpunkten Validierung und Rate Limits mitdenken
  • Keine Secrets im Klartext in Responses zurückgeben

Antwort an den Aufrufer

Mit Respond to Webhook kannst du Status und JSON zurückgeben — wichtig für Formulare und APIs, die eine Bestätigung erwarten.

{
  "ok": true,
  "received": "{{ $json.body.email }}"
}

Als Nächstes: wie du mit Expressions auf diese Daten zugreifst.