⭐ Verfügbar in den folgenden Plänen: Business
👀 Nicht sicher, welchen Plan du hast? Überprüfe dein Abonnement.
Wenn du den Business-Plan nutzt, stehen dir erweiterte Optionen zur Anpassung deines Webhook-Setups zur Verfügung:
HTTP-Methoden: Wähle zwischen
POST,PUT,GET,DELETEoderOPTIONS, je nachdem, welche Methode dein Endpoint erwartet.Custom Headers: Füge spezifische Informationen hinzu, die vom empfangenden System benötigt werden.
URL-Parameter: Ergänze feste Details wie API-Schlüssel direkt in der Webhook-URL.
Basis-Authentifizierung: Schütze deinen Webhook mit Benutzername und Passwort.
Erweiterte Payloads: Erhalte detailliertere Informationen zu jeder einzelnen Einreichung.
In diesem Artikel werden alle diese Funktionen im Detail erklärt, damit du das Beste aus deiner Webhook-Integration herausholen kannst.
🔎 Du brauchst Hilfe bei den Grundlagen? Hier findest du weitere Informationen zur allgemeinen Einrichtung von Webhooks.
HTTP Methoden
Standardmäßig sendet Heyflow Webhook-Anfragen mit der POST-Methode. Im Business-Plan kannst du dieses Verhalten anpassen, je nach den Anforderungen deines Zielsystems.
Verfügbare Optionen:
POST: (Standard) Sendet die Daten im Body der Anfrage.
PUT: Ähnlich wie POST, wird häufig für Updates verwendet.
GET: Sendet Daten über URL-Parameter (Hinweis: Der Payload wird nicht im Body übertragen).
DELETE: Fordert das Löschen einer Ressource auf dem Server an (nur für spezifische Implementierungen).
OPTIONS: Sendet Metadaten zur Anfrage. Wird hauptsächlich für CORS oder zur Prüfung unterstützter Methoden verwendet.
❗ Wähle die Methode, die dein Endpoint für den Datenempfang erwartet.
Individuelle HTTP Headers
Möchtest du benutzerdefinierte Header in deiner Webhook-Anfrage mitgeben? Du kannst beliebige Schlüssel-Wert-Paare definieren, die mitgesendet werden.
Anwendungsbeispiele:
Authentifizierungstoken
Content-Type-Spezifikationen
Individuelle API-Anforderungen
❗ Stelle sicher, dass der empfangende Server diese Header erwartet und verarbeiten kann.
URL Parameter
Du kannst feste Werte als URL-Parameter an deinen Webhook anhängen, was hilfreich ist für statische Informationen wie API-Keys oder Client-IDs.
Beispiel:
Original URL:
https://www.example.com/webhookMit Parametern:
https://www.example.com/webhook?clientID=123&apiKey=abc
❗ Dynamische Werte (wie Nutzereingaben oder Flow-Variablen) können nicht in URL-Parametern verwendet werden. Es sind nur statische Werte möglich.
Basic Authentication
Um deinen Webhook mit Basis-Authentifizierung abzusichern, kannst du einen Benutzernamen und ein Passwort angeben.
❗ Verwende diese Option, wenn dein Endpoint HTTP Basic Auth benötigt. Vermeide öffentliche URLs, wenn du sensible Zugangsdaten übermittelst.
Payloads
Business-Nutzende können erweiterte Payloads aktivieren, die eine detailliertere Struktur der übermittelten Antworten bereitstellen. Besonders hilfreich für fortgeschrittene Datenverarbeitung oder Analysen.
Einfache Webhook-Payload
Dies ist das Standardformat, das mit jedem Absenden des Flows übermittelt wird:
{
"flowID": "<YourFlowID>",
"id": "<HeyflowResponseUUID>",
"createdAt": "2025-04-24T11:18:55Z",
"fields": {
"System Label": "Value"
}
}
❗ Achtung: Wenn du möchtest, dass die Download-Links vollständige Datei-URLs sind, von denen du die Dateien programmgesteuert herunterladen kannst, musst du den Zugriff auf öffentliche Links in deinen Flow-Einstellungen aktivieren.
Erweiterte Webhook-Payload
Wenn du den Business Plan abonniert hast, kannst du auch eine erweiterte Payload senden. Dieses Format ist nützlich, wenn du einen detaillierten Kontext zu jedem Feld benötigen. Vor allem aber ändert sich der Typ der Felder von einem Objekt zu einem Array von Objekten.
{
flowID: <YourFlowID>,
id: <HeyflowResponseUUID>, // Heyflow UUID for the response
createdAt: <DateTimeOfTheResponseSubmission>, // new Date()
fields: [
{
// Each block has a static unique identifier, the ID:
"id": "mco-fb5cd9b5",
// The label is either the system label or block label you define:
"label": "Please choose an option",
// The values holds the user entered data in an array. If only one
// value can be specified, e.g. an input field, it only holds one
// object. If mutliple values can be speificed, e.g. for a Multiple
// Choice block, it holds multiple elements.
"values": [
{
"name": "mco-fb5cd9b5",
"answer": "Option 2 label"
}
],
// The variable you have specified for this block.
"variable": "mc-24115746",
// If this block is flagged as senstivive as a boolean.
"sensitive": false,
},
],
}
❗Bitte beachte: Die Struktur und der Inhalt der erweiterten Nutzlast sind von Heyflow vordefiniert und können nicht angepasst werden. Du kannst zusätzliche Informationen einfügen, indem du versteckte Eingabefelder in deinem Flow hinzufügst. Diese Felder können zusätzliche Daten erfassen (z. B. Tracking-Parameter, User-Metadaten) und werden bei der Übermittlung in die Nutzdaten aufgenommen.