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

# Update a webhook

`PUT /v2/webhooks/{webhook_id}`

Update a webhook by ID.

## Path parameters

- `webhook_id` string, required

## Request body

- object
  - `event_type` 'PING' | 'FILE_UPDATE' | 'FILE_VERSION_UPDATE' | 'FILE_DELETE' | 'LIBRARY_PUBLISH' | 'FILE_COMMENT', required — An enum representing the possible events that a webhook can subscribe to
  - `endpoint` string, required — The HTTP endpoint that will receive a POST request when the event triggers. Max length 2048 characters.
  - `passcode` string, required — String that will be passed back to your webhook endpoint to verify that it is being called by Figma. Max length 100 characters.
  - `status` 'ACTIVE' | 'PAUSED' — An enum representing the possible statuses you can set a webhook to: - `ACTIVE`: The webhook is healthy and receive all events - `PAUSED`: The webhook is paused and will not receive any events
  - `description` string — User provided description or name for the webhook. Max length 150 characters.

## Response `200`

Response from the PUT /v2/webhooks/{webhook_id} endpoint.

- WebhookV2 — A description of an HTTP webhook (from Figma back to your application)
  - `id` string, required — The ID of the webhook
  - `event_type` 'PING' | 'FILE_UPDATE' | 'FILE_VERSION_UPDATE' | 'FILE_DELETE' | 'LIBRARY_PUBLISH' | 'FILE_COMMENT', required — An enum representing the possible events that a webhook can subscribe to
  - `team_id` string, required — The team id you are subscribed to for updates
  - `status` 'ACTIVE' | 'PAUSED', required — An enum representing the possible statuses you can set a webhook to: - `ACTIVE`: The webhook is healthy and receive all events - `PAUSED`: The webhook is paused and will not receive any events
  - `client_id` string, nullable, required — The client ID of the OAuth application that registered this webhook, if any
  - `passcode` string, required — The passcode that will be passed back to the webhook endpoint
  - `endpoint` string, required — The endpoint that will be hit when the webhook is triggered
  - `description` string, nullable, required — Optional user-provided description or name for the webhook. This is provided to help make maintaining a number of webhooks more convenient. Max length 140 characters.

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `404` — The requested file or resource was not found.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

---

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