Webhooks

List

Lists the workspace's webhook subscriptions. The signing secret is never returned here - it is shown exactly once, when a webhook is created or its secret is rotated.

GET /api/{tenant:minlength(2)}/v{version:apiVersion}/webhooks

Authorisation: Minimum role: ADMIN

Request arguments

Name	Type	Source

Request body example

No input arguments

Response

Status: 200 (OK)
Type: DTO_webhook_subscription[]

Wrapper: DTO_response_wrap

Other statuses: 401 (Unauthorized), 403 (Forbidden), 429 (TooManyRequests)

Response body example

DTO_webhook_subscription

Name	Type	ReadOnly	Description
id	Int32		Id
label	String		Label
url	String		Url
event_types	String[]		Public event names this subscription listens to, e.g. "ticket.created"
secret	String	ReadOnly	Only returned on create and rotate_secret - store it, it cannot be retrieved again
custom_header_name	String		Custom header name
custom_header_value_set	Boolean	ReadOnly	Whether a custom header value is configured. The value itself is never returned
enabled	Boolean		Enabled
disabled_reason	String	ReadOnly	Why the subscription is disabled: "user" or "auto_failures" (empty when enabled)
consecutive_failure_count	Int32	ReadOnly	Consecutive failure count
last_success	DateTime (nullable)	ReadOnly	Last success
last_failure	DateTime (nullable)	ReadOnly	Last failure
created	DateTime	ReadOnly	Created
last_updated	DateTime	ReadOnly	Last updated

Generated Aug 31, 2026 16:21