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

# Update a webhook

`PATCH /v1/webhooks/{id}`

update a webhook.

## Path parameters

- `id` string, required

## Request body

- PatchedWebhookData
  - `url` string, uri — The URL of the webhook endpoint.
  - `description` string, nullable — An optional description of what the webhook is used for.
  - `enabled_events` string[] — The list of events to enable for this endpoint.
  - `disabled` boolean, nullable — Indicates that the webhook is disabled

## Response `200`

- Webhook
  - `id` string — A unique identifier
  - `url` string, uri, required — The URL of the webhook endpoint.
  - `description` string, nullable — An optional description of what the webhook is used for.
  - `enabled_events` string[], required — The list of events to enable for this endpoint.
  - `disabled` boolean, nullable — Indicates that the webhook is disabled
  - `object_type` string — Specifies the object type
  - `last_event_at` string, date-time, nullable — The datetime of the last event sent.
  - `secret` string, required — Header signature secret
  - `test_mode` boolean, required — Specified whether it was created with a carrier in test mode

## Other responses

- `400`
- `404`
- `500`

---

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