Sign in

v1

latestOpenAPI 3.1.02026-07-1750229379.2 KB
Webhooks

Get a webhook

Get a webhook by ID.

get/v2/webhooks/{webhook_id}

Path parameters

webhook_idstring required

ID of webhook to get

Response

Response from the GET /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.