> 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/english/platform-usage/alerts/webhooks/add-webhook.md).

# Add Webhook

{% hint style="warning" %}
**Please note**: A new beta version of this view is available. You can find it under [Alerts (BETA)](/docs/manual/english/platform-usage/alerts-beta.md) → [Add Webhook (BETA)](/docs/manual/english/platform-usage/alerts-beta/webhooks-beta/add-webhook-beta.md).

To use the new view, enable **Enable Beta Features** under Settings → [User Account](/docs/manual/english/administration/settings/user-account.md#advanced-settings).
{% endhint %}

***

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Create Webhook** in the upper-right corner of the [webhook overview](file:///#webhook-overview) to create a new webhook. The **Alerts** → **Webhook** → **Add** view opens.

<i class="fa-computer-mouse">:computer-mouse:</i> After configuring all settings, click **Add Webhook** to save and create the new webhook.

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Back** to return to the list view.

{% hint style="danger" %}
**Please note**: If you leave this view without clicking **Add Webhook**, all configured settings will be permanently lost.
{% endhint %}

***

## General Settings

The following options are available:

<table><thead><tr><th width="199.71484375">Option</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Enter a meaningful name for the webhook.</td></tr><tr><td>Description</td><td><p>Provide a more detailed description of the webhook.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This field is optional.</p></div></td></tr><tr><td>Target URL</td><td><p>Enter the target URL to which the webhook request should be sent.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: The required URL depends on the third-party software you want to connect to the Alert.</p></div></td></tr><tr><td>Method</td><td><p>Select the HTTP method to use when sending the request to the target URL.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default HTTP method is <strong>GET</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Method</strong> field to expand a list of all available options.<br></p><p>The following options are available:</p><ul><li><strong>GET</strong>: Retrieves data from the target system.</li><li><strong>POST</strong>: Creates new data in the target system or sends data to the target system.</li><li><strong>PATCH</strong>: Partially updates existing data in the target system.</li><li><strong>PUT</strong>: Fully updates existing data in the target system.</li><li><strong>DELETE</strong>: Deletes existing data in the target system.</li></ul></td></tr><tr><td>Content Type</td><td><p>Select the format in which the content of the HTTP request, meaning the payload, should be sent.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default content type is <strong>application/json</strong>. No other content types are currently available.</p></div></td></tr><tr><td>Payload</td><td><p>If required, enter a custom payload in the JSON format required for the selected content type.</p><div data-gb-custom-block data-tag="hint" data-style="success" data-icon="lightbulb" class="hint hint-success"><p>For more information about creating custom webhook payloads with dynamic placeholders, refer to our Knowledge Base article: <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>Leave the field empty to use the default webhook payload template.</p><div data-gb-custom-block data-tag="hint" data-style="success" data-icon="lightbulb" class="hint hint-success"><p>For more information about the available default webhook payload templates, refer to our Knowledge Base article: <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

Here you can define HTTP headers that you want to send to the target URL as additional information.

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Create HTTP Header** to display the input fields for HTTP headers.

The following options are available:

<table><thead><tr><th width="199.71484375">Option</th><th>Description</th></tr></thead><tbody><tr><td>Key</td><td>Enter the name of the HTTP header.</td></tr><tr><td>Value</td><td>Enter the corresponding value of the HTTP header.</td></tr></tbody></table>

{% hint style="warning" %}
**Please note**: The required values depend on the third-party software you want to connect to the Alert.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Remove** icon <i class="fa-circle-minus">:circle-minus:</i> next to an added HTTP header to remove it.

***

## Further Resources

**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)
