---
title: "Update webhook"
method: PUT
path: "/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Update webhook

`PUT /webhooks/{webhook_id}`

Updates a webhook.

## Path parameters

- `webhook_id` string, required

## Request body

- object
  - `target` object — The item that will trigger the webhook.
    - `id` string — The ID of the item to trigger a webhook.
    - `type` 'file' | 'folder' — The type of item to trigger a webhook.
  - `address` string — The URL that is notified by this webhook.
  - `triggers` string[] — An array of event names that this webhook is to be triggered for.

## Response `200`

Returns the new webhook object.

- Webhook — Represents a configured webhook.
  - `id` string — The unique identifier for this webhook.
  - `type` 'webhook' — The value will always be `webhook`.
  - `target` object — The item that will trigger the webhook.
    - `id` string — The ID of the item to trigger a webhook.
    - `type` 'file' | 'folder' — The type of item to trigger a webhook.
  - `created_by` object — The user who created the webhook.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
    - `name` string — The display name of this user.
    - `login` string, email — The primary email address of this user.
  - `created_at` string, date-time — A timestamp identifying the time that the webhook was created.
  - `address` string — The URL that is notified by this webhook.
  - `triggers` string[] — An array of event names that this webhook is to be triggered for.

## Other responses

- `400` — Returns an error if the parameters were incorrect.
- `403` — Returns an error if the application does not have the permission to manage webhooks.
- `404` — Returns an error if the target item or webhook could not be found.
- `409` — Returns an error if the a webhook for this combination of target, application, and user already exists.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/versions/ba8f087e1a4d/schema)