---
title: "Edit a webhook"
method: PATCH
path: "/webhooks/{id}"
tags: ["Webhooks"]
---

# Edit a webhook

`PATCH /webhooks/{id}`

Update a single webhook

## Request body

- object
  - `data` object, required
    - `attributes` object, required
      - `url` string, uri — The URL of the webhook endpoint.
      - `events` string[] — The list of events to enable for this endpoint.
      - `active` boolean
      - `headers` object[] — Optional custom headers to pass with each webhook invocation
        - `name` string — The name of the header. (Please not this will be auto-capitalized)
        - `value` string — The value to pass for the header
    - `type` 'webhook', required

## Response `200`

OK

- object
  - `data` Webhook
    - `id` string, uuid, required
    - `type` 'webhook', required
    - `attributes` object
      - `url` string, uri, required — https end point
      - `active` boolean, required — Whether the webhook will be delivered when events are triggered
      - `events` string[], required — The list of events to enabled for this endpoint
      - `secret` string, required — A random token that will sign all delivered webhooks
      - `headers` object[], nullable
        - `name` string
        - `value` string

## Changes

- **2025-10-22** `2ebc74307d64` — 1 warning, 1 info
  - added the new `container.pickup_lfd_line.changed` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.pickup_lfd_line.changed` enum value to the request property `data/attributes/events/items/`
- **2025-04-09** `bd78172c578e` — 1 warning, 1 info
  - added the new `container.transport.available` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.transport.available` enum value to the request property `data/attributes/events/items/`
- **2024-07-03** `22e310ff5a89` — 3 warning, 3 info
  - added the new `container.pickup_lfd.changed` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.transport.arrived_at_inland_destination` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.transport.estimated.arrived_at_inland_destination` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.pickup_lfd.changed` enum value to the request property `data/attributes/events/items/`
  - …2 more

[Change history](https://skmtc.dev/terminal49/apis/terminal49-api-reference/changes/webhooks/:id/patch.md)

---

[API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/002d787cbbc0/schema)