> ## Documentation Index
> Fetch the complete documentation index at: https://docs.way.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Create and manage webhooks in the Way dashboard

Webhooks are managed in the Way dashboard - there is no public API for creating them.

<Steps>
  <Step title="Open the webhooks section">
    In the Way dashboard, go to **Settings → Developers → Webhooks**.
  </Step>

  <Step title="Add a webhook">
    Click **Add webhook** and fill in:

    * **URL** - a publicly reachable HTTPS endpoint that accepts `POST` requests with a JSON body.
    * **Secret** (recommended) - any string you generate. Way uses it to sign every delivery with the `X-Way-Signature` header so you can [verify authenticity](/webhooks/verify-signatures). Store it alongside your other credentials.
    * **Events** - select which [events](/webhooks/events/overview) this webhook should receive.

    <Frame>
      <img src="https://mintcdn.com/way-54/MVWp_wPfvXq94P4I/images/Screenshot2025-03-15at8.59.14PM.png?fit=max&auto=format&n=MVWp_wPfvXq94P4I&q=85&s=4db3f8bfb729ea92b02eedcfc2252100" alt="images/Screenshot2025-03-15at8.59.14PM.png" width="2134" height="1466" data-path="images/Screenshot2025-03-15at8.59.14PM.png" />
    </Frame>
  </Step>

  <Step title="Verify it's receiving">
    Trigger a subscribed event (on staging, make a test booking - see [Testing](/webhooks/testing)) and check your endpoint received it. The dashboard's webhook logs show every delivery attempt with status and payload.
  </Step>
</Steps>

## Editing and disabling

Each webhook can be edited (URL, secret, event selection) or disabled from the same dashboard section. You can register multiple webhooks - for example, separate endpoints for booking events and financial reports.

## Requirements for your endpoint

* Respond with a `2xx` status within **10 seconds** - do heavy processing asynchronously after acknowledging.
* Expect retries: the same event can be delivered more than once. Deduplicate on business keys (for example `bookingId` + event type) - see [Delivery and retries](/webhooks/delivery-and-retries).