Webhooks
Send a webhook test event
Sends a signed test event to the endpoint in the same envelope as a real one and returns the delivery so it can be followed. It is retried like any other delivery. The endpoint must be switched on.
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
Path Parameters
id*string
The webhook's id (a UUID).
Response
Accepted
Example
{ "delivery": { "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37", "endpoint_id": "3c389a9c-ec45-4454-9d6d-d6c94dce61c4", "event_type": "example", "event_id": "910fda26-2365-4b38-9285-92086a2a6b3d", "status": "open", "attempts": 1, "response_code": 1, "last_error": "", "test": false, "created_at": "2026-10-14T08:30:00Z", "delivered_at": "2026-10-14T08:30:00Z", "next_attempt_at": "2026-10-14T08:30:00Z" }}FieldTypeDescription
deliveryrequiredobjectidrequiredstringendpoint_idrequiredstringevent_typerequiredstringevent_idrequiredstringstatusrequiredstringThe status to set.attemptsrequiredintegerresponse_coderequiredinteger | nulllast_errorrequiredstring | nulltestrequiredbooleancreated_atrequiredstringdelivered_atrequiredstring | nullnext_attempt_atrequiredstringcurl -X POST "https://api.sautidesk.com/v1/desk/webhooks/string/test"