> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://support.contracthero.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Webhooks: Echtzeit-Events aus ContractHero in Ihre Systeme senden ## Ihr Vorteil Wer Vertragsdaten in andere Systeme bringen will (Salesforce, Hubspot, Slack, BigQuery, n8n …), wartet sonst entweder auf manuelle Exporte oder pollt im Minutentakt die ContractHero-API ab. Mit Webhooks passiert genau das Gegenteil: ContractHero meldet sich von selbst, wenn etwas passiert. Sie sparen Polling-Last und reagieren in Echtzeit — typischerweise innerhalb von Sekunden nach dem Event. ## Voraussetzungen * Webhooks sind ab dem **Professional**-Plan verfügbar. * Sie benötigen einen **erreichbaren HTTPS-Endpoint**, der POST-Requests im JSON-Format entgegennimmt. * **Eigentümer-Rolle** in ContractHero mit Zugriff auf **Einstellungen → Integrationen**. ## So funktioniert's ### 1. Webhook-Bereich öffnen Navigieren Sie zu **Einstellungen → Integrationen**. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-06-15-at-17452_1kt3pjh.png) Wechseln Sie zum Reiter **„Webhooks"**. Wenn Sie noch keine Webhooks konfiguriert haben, sehen Sie den Hinweis **„Keine Webhooks hinzugefügt"**. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-06-15-at-17455_ba1mfu.png) ### 2. Neuen Webhook anlegen Klicken Sie rechts oben auf **„+ Webhook hinzufügen"**. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-06-15-at-17455_fz899m.png) Sie landen im Konfigurations-Dialog **„Webhook einrichten, um Echtzeit-Updates zu erhalten"** mit drei Bereichen: * **Webhook Name** — interne Bezeichnung, hilft beim Wiederfinden (z. B. „Slack-Alerts Legal"). * **URL** — Ihr HTTPS-Endpoint, der die Events empfangen soll. Format: `https://hooks.your-endpoint.com/updates`. Über **„URL testen"** prüfen Sie, ob ContractHero den Endpoint erreichen kann. * **Ereignisse** — Sie wählen via Checkbox, bei welchen Events der Webhook ausgelöst wird (Liste siehe unten). ![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-06-15-at-17472_1rh4mtb.png) ### 3. Events auswählen Sie können einzelne Events einzeln aktivieren oder über die Header-Checkbox alle auf einmal abonnieren. Aktuell verfügbar sind: | Event | Auslöser | | --- | --- | | `contract.created` | Ein Vertrag wird erstellt — inkl. vollständiger Vertragsdaten, Quelle (z. B. per Upload, XML-Import oder E-Mail), Ersteller und Zeitstempel. | | `contract.edited` | Ein Vertrag wird bearbeitet — inkl. Feldbewegungen, Bearbeiter (im KI-Fall: `ContractHero KI`) und Zeitstempel. | | `member_invitation.created` | Ein Mitglied wird in eine Organisation eingeladen — inkl. Org-Name, Einladender, E-Mail-Adresse, Rolle, Zeitstempel. | | `member_invitation.accepted` | Ein Mitglied hat die Einladung angenommen. | | `reminder.created` | Eine Aufgabe wird erstellt. | | `reminder.updated` | Eine Aufgabe wird aktualisiert. | | `reminder.due_date_reached` | Eine Aufgabe hat ihr Fälligkeitsdatum erreicht. | | `reminder.sent` | Es wird eine Erinnerung für eine Aufgabe gesendet. | | `summary.update` | Eine geplante Zusammenfassung wird gesendet (z. B. der monatliche Statusbericht). | ### 4. Speichern und live schalten Nach dem Speichern erscheint der Webhook in der Liste **„Webhooks"**. Ab diesem Zeitpunkt sendet ContractHero pro abonniertem Event eine **POST-Anfrage im JSON-Format** an Ihren Endpoint. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-06-15-at-17484_1kzbem9.png) ### 5. Endpoint-Side: Anfragen entgegennehmen Ihr Endpoint sollte: * **HTTPS** sprechen (kein HTTP). * Den POST-Request **schnell mit HTTP 2xx** beantworten (idealerweise unter 5 Sekunden), damit ContractHero nicht in einen Retry läuft. * Den Event-Typ aus dem Payload lesen (Schema je nach Event). * Bei Bedarf den Payload asynchron weiterverarbeiten (Queue, Worker), damit der HTTP-Response nicht blockiert. ## Häufige Fragen ### Welche Pläne enthalten Webhooks? Webhooks sind ab dem **Professional**-Plan verfügbar (Professional, Enterprise). ### Sind Webhooks ein- oder ausgehend? **Ausgehend.** ContractHero sendet bei Events HTTP-POST-Requests an Ihren Endpoint. Eingehende Aufrufe (externe Systeme schreiben in ContractHero) laufen über die [Public REST API](https://support.contracthero.com/de/article/public-rest-api-contracthero-programmatisch-ansteuern-a84vi/), nicht über Webhooks. ### Wie schnell werden Events ausgeliefert? Üblicherweise innerhalb weniger Sekunden nach dem auslösenden Ereignis. Bei Lastspitzen oder wenn Ihr Endpoint langsam antwortet, kann es länger dauern. ### Was passiert, wenn mein Endpoint kurz nicht erreichbar ist? ContractHero versucht den Webhook automatisch erneut zuzustellen. Die Anzahl und Frequenz der Retries kann je nach Event variieren — als Endpoint-Betreiber sollten Sie **idempotent** verarbeiten (gleicher Webhook darf zweimal ankommen, ohne Doppel-Effekt). ### Wie sichere ich den Endpoint gegen Missbrauch ab? Mindestens HTTPS und ein internes Geheimnis im Payload oder URL-Pfad. Wenn Sie eine Signatur-Prüfung wünschen, sprechen Sie uns an — wir prüfen das individuell. ### Welche Datenmenge wird übertragen? Bei `contract.created` und `contract.edited` enthält der Payload die **vollständigen Vertragsdaten** zum Zeitpunkt des Events — auch Feldbewegungen bei Edits. Bei Aufgaben-Events sind die Aufgaben-Metadaten enthalten. ### Kann ich Events filtern (z. B. nur eine bestimmte Kategorie)? Aktuell wählen Sie pro Webhook nur den **Event-Typ** aus. Filterung nach Kategorie, Team oder anderen Vertragsfeldern müssen Sie endpoint-seitig vornehmen. Auf Anfrage prüfen wir, ob ein servergestütztes Filtering für Ihren Use-Case sinnvoll ist. ### Kann ich mehrere Webhooks parallel betreiben? Ja. Sie können beliebig viele Webhooks anlegen — typischerweise einen pro Zielsystem (Salesforce, Slack, eigenes Tool). ### Wie teste ich, ob mein Endpoint korrekt antwortet? Im Konfigurations-Dialog steht der Button **„URL testen"** — ContractHero schickt einen Test-Request, mit dem Sie sofort sehen, ob Ihr Endpoint erreichbar ist und korrekt antwortet. ### Können Webhooks nachträglich für ältere Events ausgelöst werden? Nein — Webhooks senden ausschließlich ab dem Zeitpunkt der Aktivierung. Wenn Sie Bestandsdaten in Ihr Zielsystem überführen möchten, nutzen Sie den Export oder die API. ## Gut zu wissen * **Idempotente Verarbeitung ist Pflicht.** Bei Netzwerk-Problemen kann derselbe Webhook mehrfach ausgeliefert werden. Speichern Sie Event-IDs und prüfen Sie vor der Verarbeitung, ob das Event schon einmal verarbeitet wurde. * **Schneller 2xx-Response, asynchrone Logik.** Schreiben Sie den Payload sofort in eine Queue und antworten Sie ContractHero mit 200 OK. Lange synchron-Verarbeitung führt zu Timeouts und Retries. * **HTTPS nicht verhandelbar.** ContractHero akzeptiert nur HTTPS-Endpoints. Self-signed Zertifikate können Probleme machen — nutzen Sie ein gängiges CA-Zertifikat (Let's Encrypt etc.). * **Sprechende Webhook-Namen.** „Salesforce Vertragsanlagen", „Slack Legal-Team — Fristen erreicht" sind später wiederfindbar. „Webhook 3" nicht. * **n8n / Make / Zapier sind perfekte Erstziele.** Wenn Sie keinen eigenen Server bauen wollen, sind diese No-Code-Plattformen ideal — sie liefern Ihnen eine fertige HTTPS-URL, die Sie hier eintragen. * **Wir unterstützen beim Setup.** Wenn Sie unsicher mit der Endpoint-Konfiguration sind, gehen wir den Aufbau im Onboarding-Termin gemeinsam durch — typischerweise eine Stunde. ## Verwandte Artikel * [Public REST API: ContractHero programmatisch ansteuern](https://support.contracthero.com/de/article/public-rest-api-contracthero-programmatisch-ansteuern-a84vi/) * [Wie erstelle ich Automatisierungen?](https://support.contracthero.com/de/article/wie-erstelle-ich-automatisierungen-ke5qbj/) * [Wie verwalte ich Benachrichtigungen in ContractHero?](https://support.contracthero.com/de/article/wie-verwalte-ich-benachrichtigungen-in-contracthero-196vg3b/) * [Wie funktioniert das Aufgabenmanagement?](https://support.contracthero.com/de/article/wie-funktioniert-das-aufgabenmanagement-svgtlm/) * [Personen einladen: Wie können Rollen und Berechtigungen für zusätzliche Benutzer verwaltet werden?](https://support.contracthero.com/de/article/personen-einladen-wie-konnen-rollen-und-berechtigungen-fur-zusatzliche-benutzer-verwaltet-werden-kp2x2w/)