Sign in

v1

latestOpenAPI 3.1.02026-07-1750229379.2 KB
Webhooks

Update a webhook

Update a webhook by ID.

put/v2/webhooks/{webhook_id}

Path parameters

webhook_idstring required

ID of webhook to update

Request body

event_type'PING' | 'FILE_UPDATE' | 'FILE_VERSION_UPDATE' | 'FILE_DELETE' | 'LIBRARY_PUBLISH' | 'FILE_COMMENT' | 'DEV_MODE_STATUS_UPDATE' required

An enum representing the possible events that a webhook can subscribe to

endpointstring required

The HTTP endpoint that will receive a POST request when the event triggers. Max length 2048 characters.

passcodestring 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
descriptionstring

User provided description or name for the webhook. Max length 150 characters.

Response

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

idstring required

The ID of the webhook

event_type'PING' | 'FILE_UPDATE' | 'FILE_VERSION_UPDATE' | 'FILE_DELETE' | 'LIBRARY_PUBLISH' | 'FILE_COMMENT' | 'DEV_MODE_STATUS_UPDATE' required

An enum representing the possible events that a webhook can subscribe to

team_idstring required

The team id you are subscribed to for updates. This is deprecated, use context and context_id instead

contextstring required

The type of context this webhook is attached to. The value will be "PROJECT", "TEAM", or "FILE"

context_idstring required

The ID of the context this webhook is attached to

plan_api_idstring required

The plan API ID of the team or organization where this webhook was created

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_idstring nullable required

The client ID of the OAuth application that registered this webhook, if any

passcodestring required

The passcode that will be passed back to the webhook endpoint. For security, when using the GET endpoints, the value is an empty string

endpointstring required

The endpoint that will be hit when the webhook is triggered

descriptionstring 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.