Webhook einrichten

Der Webhook-Editor ist in die Abschnitte Ziel, Auslöser, Verknüpfung, Inhalt und Vorschau gegliedert. Die folgenden Schritte gehen sie von oben nach unten durch.

1. Editor öffnen

1. Öffne in der Seitenleiste Management.
2. Wechsle in den Tab Webhooks.
3. Klicke auf Neuer Webhook.

2. Ziel festlegen

Im Abschnitt Ziel legst Du fest, wohin die Anfrage geht.

1. Name: Gib dem Webhook einen sprechenden Namen, z. B. „CRM-Synchronisierung“ (höchstens 120 Zeichen).
2. Methode: Wähle POST, PUT, PATCH oder DELETE. Neue Webhooks starten mit POST.
3. URL: Trage die vollständige Adresse ein. Sie muss mit http:// oder https:// beginnen. In Pfad und Query kannst Du Platzhalter einsetzen, z. B. https://erp.example.com/contacts/{{ contact.id }}. Im Host sind keine Platzhalter erlaubt.
4. Header: Mit Header hinzufügen legst Du bis zu zehn eigene Header an, z. B. Authorization mit Deinem API-Token. Header-Namen dürfen nur Buchstaben, Ziffern und Bindestriche enthalten.

Gespeicherte Header-Werte

Header-Werte werden verschlüsselt gespeichert und danach nur noch maskiert angezeigt (**** plus die letzten vier Zeichen). Lässt Du ein Feld beim Bearbeiten leer, bleibt der gespeicherte Wert erhalten – Du musst ein Token also nicht neu eintippen.

Folgende Header setzt Centrics selbst; gleichnamige eigene Header werden ignoriert:

Header	Inhalt
Content-Type	application/json
User-Agent	Centrics-Webhooks/1
X-Centrics-Event	Ereignis: created, updated oder deleted
X-Centrics-Event-Id	ID des Ereignisses
X-Centrics-Delivery	ID der einzelnen Zustellung

Außerdem kannst Du Host und Content-Length nicht selbst setzen.

3. Auslöser wählen

Im Abschnitt Auslöser bestimmst Du, wann der Webhook sendet.

1. Ressource: Wähle Aufgabe, Protokoll oder Kontakt. Die Ressource kann nach dem Anlegen nicht mehr geändert werden.
2. Ereignisse: Wähle mindestens eines von Erstellt, Aktualisiert und Gelöscht. Bei einem neuen Webhook sind alle drei vorausgewählt – entferne die Haken, die Du nicht brauchst.
3. Teams (nur Aufgaben und Protokolle): Leer lassen, um alle Teams einzuschließen.
4. Typen: Leer lassen, um alle Typen einzuschließen.
5. Beobachtete Felder (nur bei Aktualisiert): Mit Alle Felder löst jede Änderung aus. Entfernst Du den Haken, wählst Du einzelne Felder aus – der Webhook wird bei „Aktualisiert“ dann nur ausgelöst, wenn sich eines dieser Felder ändert.

4. Verknüpfung (optional)

Soll die ID, die das Zielsystem beim Anlegen zurückgibt, am Datensatz in Centrics gespeichert werden, schalte Angelegten Datensatz verknüpfen ein. Wie das funktioniert, beschreibt Antwort verknüpfen.

5. Inhalt festlegen

Im Abschnitt Inhalt wählst Du unter Format, wie der Request-Body aussieht.

Standard

Der Webhook sendet ein festes JSON-Format. Der Editor zeigt es Dir mit Beispieldaten an:

{
  "event": "updated",
  "resource": "contact",
  "id": "7d4f2a10-2222-4c1b-9c00-000000000002",
  "occurred_at": "2026-01-15T09:30:00Z",
  "actor": { "id": "…", "name": "Erika Muster", "email": "erika@example.com", "source": "user" },
  "account": { "id": "…", "name": "Muster GmbH" },
  "data": { "…": "alle Felder des Datensatzes" },
  "changes": { "…": "nur bei updated: geänderte Felder mit old und new" }
}

Benutzerdefiniert

Du schreibst Dein eigenes JSON und setzt Werte aus dem Datensatz als Platzhalter ein. Variablen fügst Du per Klick oder Drag & Drop aus der Liste neben dem Editor ein, oder Du tippst {{, um Vorschläge zu sehen.

Über Vorlage einfügen startest Du mit einer Leeren Vorlage, der Standard-Vorlage oder – bei Kontakten – der Vorlage Kontakt-Synchronisierung. Eine Vorlage ersetzt Deinen aktuellen Inhalt.

Die Vorlage muss gültiges JSON sein und darf nur Variablen aus der Liste verwenden. Andernfalls lässt sich der Webhook nicht speichern, und der Editor zeigt Dir, was nicht stimmt.

6. Ohne Speichern testen

Im Abschnitt Vorschau siehst Du, welche URL und welcher Inhalt gesendet würden.

1. Wähle unter Beispiel entweder Beispieldaten oder Echte Ressource. Bei einer echten Ressource suchst Du einen bestehenden Datensatz aus.
2. Wähle das Ereignis für den Test (nur Ereignisse, die Du im Auslöser angehakt hast).
3. Klicke auf Test senden.

Der Test sendet die aktuelle Konfiguration aus dem Editor, auch ungespeichert, mit dem gewählten Beispiel. Es wird nichts gespeichert und nichts verknüpft. Du siehst den HTTP-Status, die Dauer, den gesendeten Request und die Antwort des Zielsystems. Ist die Antwort JSON, kannst Du auf einen Wert klicken, um ihn als Pfad für die Verknüpfung zu übernehmen.

Achtung

Auch der Test ist eine echte Anfrage. Ein Test mit POST gegen eine Produktiv-API legt dort wirklich einen Datensatz an.

7. Speichern, aktivieren, deaktivieren

• Klicke auf Speichern. Ein neuer Webhook ist sofort Aktiv und reagiert ab dann auf Änderungen.
• In der Liste öffnest Du über das Menü … einer Zeile die Aktionen Bearbeiten, Duplizieren, Zustellungen, Aktivieren bzw. Deaktivieren und Löschen.
• Deaktivieren stoppt den Webhook und bricht offene Zustellungen ab. Beim erneuten Aktivieren werden nur Ereignisse ab diesem Zeitpunkt gesendet – Verpasstes wird nicht nachgeholt.
• Löschen stoppt den Webhook endgültig und bricht offene Zustellungen ab.

Duplizieren

Duplizieren legt eine Kopie an – inklusive der gespeicherten Header-Werte. Ihr Name wird um „(Kopie)“ ergänzt, z. B. „CRM-Synchronisierung (Kopie)“. Die Kopie ist inaktiv, bis Du sie aktivierst. So kannst Du zum Beispiel Filter oder Vorlage anpassen, bevor die Kopie parallel zum Original sendet. Auch Kopien zählen zur Höchstzahl von Webhooks pro Account.