Webhooks

Configure webhook

Creates or updates the webhook configuration for the authenticated WUTS device. WUTS delivers the selected events to your endpoint and invalidates the cached configuration so the new settings take effect immediately.

POST
/webhook

Creates or updates the webhook configuration for the authenticated WUTS device. WUTS delivers the selected events to your endpoint and invalidates the cached configuration so the new settings take effect immediately.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/webhook" \  -H "Content-Type: application/json" \  -d '{    "webhook_url": "https://app.example.com/integrations/wuts/webhook",    "enabled_events": [      "message.received",      "message.sent",      "message.delivered",      "message.read"    ],    "enabled": true,    "retry_attempts": 3,    "timeout": 30,    "secret": "whsec_9f3c1a2b7d4e5f60",    "headers": {      "X-Tenant-Id": "acme-corp"    }  }'
{  "success": true,  "message": "Webhook configured successfully",  "webhook": {    "id": "wh_3EB0a1b2c3d4e5f6",    "webhook_url": "https://app.example.com/integrations/wuts/webhook",    "enabled_events": [      "message.received",      "message.sent",      "message.delivered",      "message.read"    ],    "enabled": true,    "retry_attempts": 3,    "timeout": 30,    "headers": {      "X-Tenant-Id": "acme-corp"    },    "created_at": "2026-06-15T12:30:00Z",    "updated_at": "2026-06-15T12:30:00Z"  }}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Update a user PUT

Updates a WUTS user's active flag and/or role. The caller must have permission to manage the target user; changing a role additionally requires permission for that specific role transition.

Delete webhook configuration DELETE

Removes the webhook configuration for the authenticated WUTS device and invalidates the cached configuration. After deletion WUTS stops delivering events to your endpoint.