Delete Webhook

Delete an active webhook subscription. Events will no longer be sent to the endpoint after deletion.

DELETE https://api.figma.com/v2/webhooks/:webhook_id

Authentication

Requires a valid access token with webhooks:write scope. Pass via X-Figma-Token header (personal access token) or Authorization: Bearer header (OAuth).

Parameters

Path parameters

The ID of the webhook to delete. Retrieve webhook IDs from the Get Webhooks endpoint.

Example Request

curl -X DELETE "https://api.figma.com/v2/webhooks/WEBHOOK_ID" \
  -H "X-Figma-Token: YOUR_TOKEN"

Response

Returns 200 OK with the deleted webhook details.

{
  "id": "wh_123456",
  "status": "DELETED"
}

Response Fields

Field	Type	Description
`id`	`string`	The ID of the deleted webhook
`status`	`string`	Always `DELETED` on success

Webhook deletion is immediate and cannot be undone. If you need the same subscription later, you will need to create a new webhook with the Create Webhook endpoint.