> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/bedienung-der-plattform/alarme/webhooks/webhook-hinzufugen.md).

# Webhook hinzufügen

{% hint style="warning" %}
**Bitte beachte**: Für diese Ansicht ist eine neue Version im Beta-Status verfügbar. Du findest sie unter [Alarme (BETA)](/docs/manual/bedienung-der-plattform/alarme-beta.md) → [Webhook hinzufügen (BETA)](/docs/manual/bedienung-der-plattform/alarme-beta/webhooks-beta/webhook-hinzufugen-beta.md).

Um die neue Ansicht nutzen zu können, musst du die Option **Beta-Funktionalitäten aktivieren** unter Einstellungen → [Benutzerkonto](/docs/manual/administration/einstellungen/benutzerkonto.md#erweiterte-einstellungen) aktivieren.
{% endhint %}

***

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Webhook erstellen** in der rechten oberen Ecke der [Webhook-Übersicht](/docs/manual/bedienung-der-plattform/alarme/webhooks.md#webhook-ubersicht), um einen neuen Webhook zu erstellen. Es öffnet sich die Ansicht **Alarme** → **Webhook** → **Hinzufügen**.

<figure><img src="/files/hUDigFb2jMj6zSBTaqL0" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Webhook hinzufügen**, nachdem du alle Einstellungen vorgenommen hast, um den neuen Webhook zu speichern und erstellen.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Zurück**, um zurück zur Listenübersicht zu gelangen.

{% hint style="danger" %}
**Bitte beachte**: Verlässt du diese Ansicht, ohne auf **Webhook hinzufügen** zu klicken, sind alle vorgenommenen Einstellungen unwiederbringlich verloren!
{% endhint %}

***

## Grundeinstellungen

<figure><img src="/files/l1Zcm4e1jxpJ14WX5rQo" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.71484375">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Name</td><td>Gib dem Webhook einen aussagekräftigen Namen.</td></tr><tr><td>Beschreibung</td><td><p>Beschreibe den Webhook genauer.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Dieses Feld ist optional.</p></div></td></tr><tr><td>URL-Target</td><td><p>Gib die Ziel-URL ein, an die die Webhook-Anfrage gesendet werden soll.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Bitte beachte</strong>: Welche URL hier erforderlich ist, hängt von der Drittanbieter-Software ab, die du mit dem Alarm verknüpfen möchtest.</p></div></td></tr><tr><td>Methode</td><td><p>Lege fest, mit welcher HTTP-Methode die Anfrage an die Ziel-URL gesendet werden soll.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Die standardmäßig angegebene HTTP-Methode ist <strong>GET</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Methode</strong>, um eine Liste aller verfügbaren Optionen auszuklappen.<br></p><p>Folgende Optionen stehen zur Verfügung:</p><ul><li><strong>GET</strong>: Diese Methode ruft Daten vom Zielsystem ab.</li><li><strong>POST</strong>: Diese Methode erstellt neue Daten im Zielsystem oder übermittelt Daten an das Zielsystem.</li><li><strong>PATCH</strong>: Diese Methode aktualisiert bestehende Daten im Zielsystem teilweise.</li><li><strong>PUT</strong>: Diese Methode aktualisiert bestehende Daten im Zielsystem vollständig.</li><li><strong>DELETE</strong>: Diese Methode löscht bestehende Daten im Zielsystem.</li></ul></td></tr><tr><td>Content-Typ</td><td><p>Lege fest, in welchem Format der Inhalt der HTTP-Anfrage (der Payload) übermittelt werden soll.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Der standardmäßig ausgewählte Content-Typ ist <strong>application/json</strong>. Aktuell steht kein weiterer Content-Typ zur Auswahl zur Verfügung.</p></div></td></tr><tr><td>Payload</td><td><p>Gib bei Bedarf einen benutzerdefinierten Payload im für den ausgewählten Content-Typ erforderlichen JSON-Format ei</p><div data-gb-custom-block data-tag="hint" data-style="success" data-icon="lightbulb" class="hint hint-success"><p>Mehr Informationen, wie du benutzerdefinierte Webhook-Payloads mit dynamischen Platzhaltern erstellst, findest du in unserer Knowledge Base: <a href="https://docs.enginsight.com/docs/knowledge-base/alarme/wie-erstelle-ich-fur-enginsight-alarme-eigene-webhook-payloads-mit-dynamischen-platzhaltern">Wie erstelle ich für Enginsight Alarme eigene Webhook-Payloads mit dynamischen Platzhaltern?</a></p></div><p>Lasse das Feld leer, wenn du das Standard-Template für Webhook-Payloads verwenden möchtest.</p><div data-gb-custom-block data-tag="hint" data-style="success" data-icon="lightbulb" class="hint hint-success"><p>Mehr Informationen, welche Standard-Templates es für Webhook-Payloads gibt, findest du in unserer Knowledge Base: <a href="https://docs.enginsight.com/docs/knowledge-base/alarme/welche-standard-templates-fur-webhook-payloads-gibt-es-bei-enginsight-alarmen">Welche Standard-Templates für Webhook-Payloads gibt es bei Enginsight Alarmen?</a></p></div></td></tr></tbody></table>

***

## HTTP-Headers

Hier kannst du HTTP-Header definieren, die du als Zusatzinformation an die Ziel-URL übergeben möchtest.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **HTTP-Header hinzufügen**, um Eingabefelder für HTTP-Header anzuzeigen.

<figure><img src="/files/WB3xAcY9JTqGKwcmwhmK" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.71484375">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Schlüssel</td><td>Gib die Bezeichnung des HTTP-Headers ein.</td></tr><tr><td>Wert</td><td>Gib den zugehörigen Wert des HTTP-Headers ein.</td></tr></tbody></table>

{% hint style="warning" %}
**Bitte beachte**: Welche Werte hier erforderlich sind, hängt von der Drittanbieter-Software ab, die du mit dem Alarm verknüpfen möchtest.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Entfernen**-Symbol <i class="fa-circle-minus">:circle-minus:</i> neben einem hinzugefügten HTTP-Header, um ihn wieder zu entfernen.

***

## Weitere Ressourcen

**Knowledge Base**

* [Welche Standard-Templates für Webhook-Payloads gibt es bei Enginsight Alarmen?](https://docs.enginsight.com/docs/knowledge-base/alarme/welche-standard-templates-fur-webhook-payloads-gibt-es-bei-enginsight-alarmen)
* [Wie erstelle ich für Enginsight Alarme eigene Webhook-Payloads mit dynamischen Platzhaltern?](https://docs.enginsight.com/docs/knowledge-base/alarme/wie-erstelle-ich-fur-enginsight-alarme-eigene-webhook-payloads-mit-dynamischen-platzhaltern)