> **Source:** https://knowledge.leegality.com/document-execution/api/webhooks-v4/webhook-v4-event-types
> **Site:** Leegality Knowledge Base — https://knowledge.leegality.com
> **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration.
> **Navigation:** Every article on this site has a plain-text version at `<article-url>.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt
> **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt

---
# Webhook 4.0 Event Types

Every Webhook 4.0 payload carries two discriminators: `webhookType`, which tells you the route that delivered the event, and `eventType`, which tells you what actually happened. **Branch your handling on `eventType`, not on the route.**

## The two discriminators

- **`webhookType`** — the delivery route. `SUCCESS` events are delivered to `successWebhook`; `FAILED` events are delivered to `errorWebhook`.
- **`eventType`** — what happened. One of seven values, always present and never null on either route. This is the field you branch on.

## Success events

Delivered to `successWebhook` (`webhookType: SUCCESS`).

- [Signed](https://knowledge.leegality.com/document-execution/api/webhook-signed) — a signer completed a signature on the document.
- [Reviewer Approved](https://knowledge.leegality.com/document-execution/api/webhook-reviewer-approved) — a reviewer approved the document.
- [Reviewer Rejected](https://knowledge.leegality.com/document-execution/api/webhook-reviewer-rejected) — a reviewer rejected the document (`rejectionReason` set). Note this still arrives on the success URL.

## Failure events

Delivered to `errorWebhook` (`webhookType: FAILED`).

- [Signer Rejected](https://knowledge.leegality.com/document-execution/api/webhook-signer-rejected) — a signer rejected the invitation.
- [Verification Failed](https://knowledge.leegality.com/document-execution/api/webhook-verification-failed) — a recorded verification failure (certificate details, signature, face match, face verification, or liveliness) was found; `messages[]` is populated.
- [Aadhaar Retry Exhausted](https://knowledge.leegality.com/document-execution/api/webhook-aadhaar-retry-exhausted) — the invitee exhausted the permitted Aadhaar eSign retry attempts; `messages[]` is populated.
- [Invitation Timeout](https://knowledge.leegality.com/document-execution/api/webhook-invitation-timeout) — the invitation expired with no failure recorded against it.