Zum Hauptinhalt springen
POST
Webhook-Endpunkt erstellen
Registriert einen neuen Webhook-Endpunkt für den authentifizierten Mandanten. Der Endpunkt empfängt HTTP-POST-Anfragen, wenn passende Ereignisse auftreten. Das Endpunkt-Geheimnis wird einmal in der Antwort zurückgegeben – speichern Sie es sicher.
Die Anzahl der Webhook-Endpunkte, die Sie erstellen können, hängt von Ihrem Abrechnungsplan ab. Wenn Sie Ihr Planlimit überschreiten, gibt die API 402 Payment Required zurück.

Antworten

Das Feld secret wird nur in der Erstellungsantwort zurückgegeben. Speichern Sie es sicher – Sie können es später nicht wieder abrufen. Wenn Sie es verlieren, rotieren Sie das Geheimnis](/de/api-reference/webhooks/rotate-secret), um ein neues zu generieren.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Body

application/json
name
string
erforderlich

Menschenlesbarer Endpunktname

url
string
erforderlich

HTTPS-URL für Webhook-Zustellungen

event_filters
string[]
erforderlich

Ereignistypen oder Wildcard-Muster

Antwort

Endpunkt erstellt

id
string
name
string
url
string
status
string
secret
string
event_filters
string[]
created_at
string