Overview

The Webhooks API allows registering webhook URLs to receive real-time event notifications from the Truss platform. Each webhook subscription specifies which events to deliver (e.g., mandate.created, evidence.signed). Events are posted as HTTP requests to the registered URL.

Endpoints

MethodPathDescription
POST/webhooksRegister a webhook with event subscriptions
GET/webhooksList registered webhooks
DELETE/webhooks/:idDelete a webhook

Example

curl -X POST http://localhost:4000/webhooks \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/webhook","events":["mandate.created","evidence.signed"]}'