mirror of
https://github.com/documenso/documenso.git
synced 2026-07-14 23:07:13 +10:00
Lucas Smith
56 lines
1.1 KiB
Plaintext
56 lines
1.1 KiB
Plaintext
---
|
|
title: Webhooks
|
|
description: Receive real-time notifications when documents are signed, completed, or updated.
|
|
---
|
|
|
|
## How Webhooks Work
|
|
|
|
1. You configure a webhook URL in Documenso
|
|
2. When an event occurs, Documenso sends an HTTP POST to your URL
|
|
3. Your application processes the event and responds with 200 OK
|
|
|
|
---
|
|
|
|
## Getting Started
|
|
|
|
<Cards>
|
|
<Card
|
|
title="Setup"
|
|
description="Configure webhook endpoints."
|
|
href="/docs/developers/webhooks/setup"
|
|
/>
|
|
<Card
|
|
title="Events"
|
|
description="Available webhook event types."
|
|
href="/docs/developers/webhooks/events"
|
|
/>
|
|
<Card
|
|
title="Verification"
|
|
description="Verify webhook signatures for security."
|
|
href="/docs/developers/webhooks/verification"
|
|
/>
|
|
</Cards>
|
|
|
|
---
|
|
|
|
## Example Payload
|
|
|
|
```json
|
|
{
|
|
"event": "DOCUMENT_COMPLETED",
|
|
"payload": {
|
|
"id": 123,
|
|
"title": "Contract",
|
|
"status": "COMPLETED"
|
|
},
|
|
"createdAt": "2024-01-15T10:30:00.000Z",
|
|
"webhookEndpoint": "https://your-endpoint.com/webhook"
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## See Also
|
|
|
|
- [Document Lifecycle](/docs/concepts/document-lifecycle) - Understanding document statuses
|