Webhooks

How Webhooks Work

You configure a webhook URL in Documenso
When an event occurs, Documenso sends an HTTP POST to your URL
Your application processes the event and responds with 200 OK

Documenso supports webhook events for the full document lifecycle (created, sent, opened, signed, completed, rejected, cancelled) as well as template events (created, updated, deleted, used).

Getting Started

Setup

Configure webhook endpoints.

Events

Available webhook event types.

Verification

Verify webhook signatures for security.

Example Payload

{
  "event": "DOCUMENT_COMPLETED",
  "payload": {
    "id": 123,
    "title": "Contract",
    "status": "COMPLETED",
    "completedAt": "2024-01-15T10:30:00.000Z",
    "recipients": [
      {
        "id": 1,
        "email": "signer@example.com",
        "signingStatus": "SIGNED"
      }
    ]
  },
  "createdAt": "2024-01-15T10:30:00.000Z",
  "webhookEndpoint": "https://your-endpoint.com/webhook"
}