Webhooks

Get webhook configuration

Retrieves the current webhook configuration for the authenticated WUTS device, including the delivery URL, enabled events, retry policy, and custom headers.

GET
/webhook

Retrieves the current webhook configuration for the authenticated WUTS device, including the delivery URL, enabled events, retry policy, and custom headers.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/webhook"
{  "success": true,  "webhook": {    "id": "wh_3EB0a1b2c3d4e5f6",    "webhook_url": "https://app.example.com/integrations/wuts/webhook",    "enabled_events": [      "message.received",      "message.sent",      "device.connected",      "device.disconnected"    ],    "enabled": true,    "retry_attempts": 3,    "timeout": 30,    "headers": {      "X-Tenant-Id": "acme-corp"    },    "created_at": "2026-06-15T12:30:00Z",    "updated_at": "2026-06-15T13:05:42Z"  }}
{  "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"}

List available webhook events GET

Returns the full list of event types that WUTS can deliver to a webhook, covering message, device, connection, contact, chat, group, call, authentication, privacy, settings, label, newsletter, and sync events.

Set my webhook URL POST

Stores a pending webhook URL for the authenticated user. WUTS automatically applies this URL, subscribed to every available event, when the user creates and connects a new device.