---
title: "Walkthrough: Creating and configuring a webhook event handler"
slug: "walkthrough--creating-and-configuring-a-webhook-event-handler"
abstract: "Describes how to create and configure a webhook event handler."
---
# Walkthrough: Creating and configuring a webhook event handler

You can create a webhook event handler to inform you when an event occurs.

This walkthrough describes how to:

- Create a webhook event handler.
- Configure a webhook event handler.

<details>
<summary><h2>Create a webhook event handler</h2></summary>

To create a webhook event handler:

1. In the content tree, navigate to the */sitecore/System/Webhooks* folder.
2. Right-click **Webhooks**, then click **Insert**, **Webhook Event Handler**.
3. In the **Message** dialog, enter a name for the webhook, then click **OK**.

</details>

<details>
<summary><h2>Configure a webhook event handler</h2></summary>

When you create a webhook event handler, you must configure its [fields](https://doc.sitecore.com/xp/en/developers/104/sitecore-experience-manager/webhook-event-handler-configuration-fields.html "Webhook event handler configuration fields") to choose the events that trigger requests, the items that trigger requests, and where to send the requests.

You can configure a webhook event handler from the content area of the webhook item.

To configure a webhook event handler:

1. In the content area of the webhook, in the **Information** section, in the **Description** field, enter a description for the webhook.
2. In the **Data** section, in the **Events** field, in the *Event Types* folder, double-click the [events](https://doc.sitecore.com/xp/en/developers/104/sitecore-experience-manager/webhook-event-handler-configuration-fields.html#UUID-6ca1c12a-59f3-47a2-dbf3-ef37908f5565_section-idm4582546154470433140652700487 "Supported events") you want to trigger requests.
3. To add rules using the [Rule Set Editor](https://doc.sitecore.com/xp/en/users/104/sitecore-experience-platform/the-rule-set-editor.html), in the **Rule** field, click **Edit rule**.

    > [!note]
    > You can specify the items that trigger requests by adding rules. If you do not add any rules, an event from any item sends a request. We highly recommend that you add rules to avoid performance degradation caused by sending a large number of requests.
    >
    > You can't set any Rule for Publish events.

4. To enable the webhook, select the **Enabled** check box.
5. In the **Url** field, enter the endpoint URL for the requests.
6. Optionally, if the destination endpoint requires authentication, in the **Authorization** drop-down menu, click the authorization item you want to use.

    If the appropriate authorization item is not available, you can [create a new authorization item](https://doc.sitecore.com/xp/en/developers/104/sitecore-experience-manager/walkthrough--using-an-authorization-item.html "Walkthrough: Using an authorization item").

7. In the **Serialization Type** drop-down menu, click the payload type you want to use for the [webhook event handler request](https://doc.sitecore.com/xp/en/developers/104/sitecore-experience-manager/webhook-event-handler-http-request.html "Webhook event handler HTTP request").

    If you do not choose a serialization type, JSON is selected by default.

8. Click **Save**.

</details>