documenso-webhooks-events

# Documenso Webhooks & Events ## Overview Configure and handle Documenso webhooks for real-time document lifecycle notifications. Webhooks require a Teams plan or higher. The webhook secret is sent via the `X-Documenso-Secret` header (not HMAC-signed -- it is a shared secret comparison). ## Prerequisites - Documenso team account (webhooks require teams) - HTTPS endpoint for webhook reception - Completed `documenso-install-auth` setup ## Supported Events | Event | Trigger | Use Case | |-------|---------|----------| | `document.created` | New document created | Audit logging | | `document.sent` | Document sent for signing | Start SLA timers | | `document.opened` | Recipient opens the document | Track engagement | | `document.signed` | One recipient completes signing | Progress tracking | | `document.completed` | All recipients have signed | Trigger downstream workflows | | `document.rejected` | Recipient rejects | Alert sender, escalate | | `document.cancelled` | Sender cancels document | Cleanup, notify recipients | ## Instructions ### Step 1: Create Webhook via Dashboard 1. Log into Documenso, navigate to **Team Settings > Webhooks**. 2. Click **Create Webhook**. 3. Enter your **HTTPS endpoint URL**. 4. Select the events you want to receive. 5. (Optional) Enter a **webhook secret** -- this value will be sent as-is in the `X-Documenso-Secret` header on every request. 6. Save. ### Step 2: Webhook Handler (Express) ```typescript // src/webhooks/documenso.ts import exp...