documenso-webhooks-events

name	documenso-webhooks-events
description	Implement Documenso webhook configuration and event handling. Use when setting up webhook endpoints, handling document events, or implementing real-time notifications for document signing. Trigger with phrases like "documenso webhook", "documenso events", "document completed webhook", "signing notification".
allowed-tools	Read, Write, Edit, Bash(curl:*), Bash(ngrok:*)
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
compatible-with	claude-code, codex, openclaw
tags	["saas","documenso","webhooks"]

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)

// src/webhooks/documenso.ts
import express from "express";

const router = express.Router();
  = process..!;


 () {
   secret = req.[];
   (!secret || secret !== ) {
    .();
     res.().({ :  });
  }
  ();
}

router.(, express.(), verifySecret,  (req, res) => {
   { event, payload } = req.;
  .();

  
  res.().({ :  });

  
   {
     (event, payload);
  }  (err) {
    .(, err);
  }
});

  () {
   (event) {
     :
      
       (payload);
      ;
     :
      
       (payload);
      ;
     :
      
       (payload);
      ;
     :
      
      .();
      ;
    :
      .();
  }
}

  () {
   { id, title, recipients } = payload;
  .();
  
}

  () {
  .();
  
}

  () {
  .();
  
}

  router;