> **Source:** https://knowledge.leegality.com/document-execution/api/signer-rejects-document > **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 `.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 /your-webhook-endpoint/signer-rejects — Signer Rejected Fires when a signer explicitly rejects a document. Delivered to the **Error Webhook URL** configured on the invitee in the workflow. **Authentication:** `X-Auth-Token` header required on every request. ## Request URL ``` WEBHOOK https://app1.leegality.com/api/your-webhook-endpoint/signer-rejects ``` **Environments:** - Production: `https://app1.leegality.com/api/your-webhook-endpoint/signer-rejects` - Sandbox: `https://sandbox.leegality.com/api/your-webhook-endpoint/signer-rejects` --- ## Request Body **Content-Type:** `application/json` | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `webhookType` | string | No | Indicates whether this is a success or error event. Allowed: `Success`, `Error`. | `Error` | | `documentId` | string | No | The unique Leegality document ID. Use with the [Details API](https://knowledge.leegality.com/document-execution/api/check-document-details) to fetch full document information. | `01KMFPEMC6907ERY22NBBMEEHA` | | `documentStatus` | string | No | The document's status at the time of this event. - `"Sent"` — one or more invitees are still pending. - `"Completed"` — all invitees have acted. Allowed: `Draft`, `Sent`, `Completed`. | `Sent` | | `irn` | string | No | Internal Reference Number from the original eSigning request. | `null` | | `mac` | string | No | HMAC-SHA1 of `documentId` using your Private Salt. Use to [verify the webhook](https://knowledge.leegality.com/document-execution/api/webhooks/verify-webhook-request). | `7e70aaef3f77eb72d3df19c4411e2d397c48c173` | | `messages` | array | No | An array of event messages. | `` | | `verification` | object | No | Certificate verification results. Not applicable to rejection events. | `null` | | `request` | object | No | Details about the invitee associated with this webhook event. See **request** below. | — | #### request Details about the invitee associated with this webhook event. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `inviteeType` | string | No | The role of the invitee in the workflow. Allowed: `Signer`. | `Signer` | | `name` | string | No | The full name of the invitee. | `Abhishek Sharma` | | `email` | string | No | The email address of the invitee. | `abhishek@example.com` | | `phone` | string | No | The phone number of the invitee. | `null` | | `invitationUrl` | string | No | The URL for this invitee to sign or review the document. | `https://sandbox.leegality.com/sign/3990a31a-19fa-48f3-b032-e` | | `active` | boolean | No | Indicates whether it is this invitee's turn to act in the signing sequence. | `true` | | `action` | string | No | The action taken by the invitee. Allowed: `Rejected`. | `Rejected` | | `error` | string | No | Error message for this event. | `Invitation rejected by the signer.` | | `expired` | boolean | No | Indicates whether the invitation has been terminated. | `false` | | `expiryDate` | string | No | The date and time the invitation is configured to expire. Format: `dd-MM-yyyy HH:mm:ss`. | `03-04-2026 23:59:59` | | `rejectionMessage` | string | No | The rejection reason provided by the signer. Retrieve the signer's reason via the [Details API](https://knowledge.leegality.com/document-execution/api/check-document-details) using `invitations_invitationStatus_signRejectionMessage`. | `null` | | `signType` | string | No | The signature method used. Allowed: `null`. | `null` | ### Sample Request ```json { "webhookType": "Error", "documentId": "01KMFPEMC6907ERY22NBBMEEHA", "documentStatus": "Sent", "irn": null, "mac": "7e70aaef3f77eb72d3df19c4411e2d397c48c173", "messages": [], "verification": null, "request": { "inviteeType": "Signer", "name": "Abhishek Sharma", "email": "abhishek@example.com", "phone": null, "invitationUrl": "https://sandbox.leegality.com/sign/3990a31a-19fa-48f3-b032-e45b6edd836d", "active": true, "action": "Rejected", "error": "Invitation rejected by the signer.", "expired": false, "expiryDate": "03-04-2026 23:59:59", "rejectionMessage": null, "signType": null } } ``` --- ## Responses ### 2XX — Return any 2XX status code (200, 201, or 202) to acknowledge receipt. No specific response body is required. Any 2XX status code is accepted.