---
id: webhooks
sidebar_label: Webhooks
title: Managing webhooks
hide_title: true
---

import Ingress from '../../../src/components/ingress/ingress.react';

<Ingress title="Managing webhooks">
  A webhook tells Walley where to send updates about your orders. Create, test, and manage webhooks on the Webhooks tab in Manage Organization.
</Ingress>

## Before you start

- You need the **Webhook Management** permission.
- Open **Manage Organization**. Select your name in the top right and pick it from the menu.
- Read the [webhooks overview](/docs/webhooks/overview) for the events you can subscribe to and how to verify the signature.

## Create a webhook

1. Select **Create new** and then **Webhook**.
2. Fill in the webhook details:
   - The HTTPS endpoint Walley should call
   - The events you want to subscribe to
   - The stores that should generate the events
   - The authentication to use
3. Select **Create**.
4. Copy the HMAC key from the dialog that opens and store it safely. You need it to verify incoming webhooks.

Hover over an event or store to see more details in a tooltip.

<video controls src="/videos/merchanthub/create-webhook.webm" type="video/webm" width="80%">
  Your browser does not support embedded videos.
</video>

## Test a webhook

1. Open the menu on the right side of the webhook's row.
2. Select **Test configuration**.
3. Choose the event to test.
4. Select **Test**.

A dialog shows the response code from your endpoint. A successful test returns 200.

<video controls src="/videos/merchanthub/test-webhook.webm" type="video/webm" width="80%">
  Your browser does not support embedded videos.
</video>

## Disable or enable a webhook

1. Open the menu on the right side of the webhook's row.
2. Select **Disable** or **Enable**.

## Delete a webhook

:::warning Deleting a webhook cannot be undone
Walley stops sending events to the endpoint as soon as you delete it.
:::

1. Open the menu on the right side of the webhook's row.
2. Select **Delete**.

<img src="/img/merchanthub/webhook-page.png" alt="The webhooks tab listing configured webhooks with a menu on each row" />

## Failed webhooks

A failed webhook is an event that Walley could not deliver to your endpoint. Review them on the **Failed webhooks** tab.

1. Tick the webhooks you want to resend or delete, or tick the checkbox in the header to select all.
2. Select **Resend** or **Delete**.

<img src="/img/merchanthub/failed-webhooks.png" alt="The failed webhooks tab with checkboxes on each row and resend and delete buttons" />

Select a row to open the details of a failed webhook.

<img src="/img/merchanthub/failed-webhook-details.png" alt="The details dialog for a failed webhook" />