Webhooks
List webhooks
Lists the workspace's webhook endpoints with their events, whether each is switched on and the result of the newest delivery. The signing secret is never returned, only its first eight characters.
Requires: desk.admin scope, workspace owner or admin.
Authorization
bearerAuth AuthorizationBearer <token>
A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.
In: header
Response
OK
Example
{ "webhooks": [ { "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37", "url": "https://example.com/file", "description": "example", "events": [ "example" ], "enabled": false, "secret_prefix": "example", "created_by": "example", "created_at": "2026-10-14T08:30:00Z", "updated_at": "2026-10-14T08:30:00Z", "last_delivery": { "status": "open", "at": "example" } } ], "max": 10}FieldTypeDescription
webhooksrequiredobject[]idrequiredstringurlrequiredstringdescriptionrequiredstringeventsrequiredstring[]enabledrequiredbooleanTrue to switch it on, false to switch it off.secret_prefixrequiredstringcreated_bystring | nullcreated_atrequiredstringupdated_atrequiredstringlast_deliveryrequiredanystatusrequiredstringThe status to set.atrequiredstringmaxrequiredanycurl -X GET "https://api.sautidesk.com/v1/desk/webhooks"