---
title: "Change the address or events of a webhook, or turn it off / on."
method: PATCH
path: "/webhooks/{id}"
tags: ["Webhooks"]
---

# Change the address or events of a webhook, or turn it off / on.

`PATCH /webhooks/{id}`

## Request

- Base URL: `https://wowreveal.com/api/v1`
- URL: `https://wowreveal.com/api/v1/webhooks/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `url` string
  - `events` string[]
  - `enabled` boolean

## Response `200`

Success

- object
  - `webhook` Webhook, required
    - `id` integer, required
    - `url` string, uri, required
    - `events` string[], required
    - `enabled` boolean, required
    - `disabledReason` 'failing', nullable, required
    - `lastDelivery` object, nullable, required
      - `at` string, date-time, required
      - `ok` boolean, required
      - `status` integer, nullable, required
    - `createdAt` string, date-time, required

## Other responses

- `400`: Invalid request (VALIDATION_ERROR and other 400 codes).
- `401`: Missing or revoked API key (INVALID_API_KEY).
- `403`: The plan has no API access, or the account is blocked.
- `429`: Rate limit (RATE_LIMITED) — see the Retry-After header.

---

[API](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api.md) · [All operations](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api/revisions/cb44d779f713?raw)