> **Source:** https://knowledge.leegality.com/document-execution/leegality-features/invitee-level/custom-url-and-webhook/webhook-and-url
> **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

---
# Add custom URLs and webhooks

Custom URLs and webhooks provide a flexible way to manage signer journeys and receive document-related updates based on specific events during the eSign process. These configurations allow organizations to redirect signers to specific pages or receive structured payloads for enhanced tracking and integration with external systems.

## Use Custom URLs and Webhooks

#### V3 Workflow

1. On the **Invitee Card**, click **Invitee Level Options** (labelled **More Options** in a workflow).
2. Enable **Add custom URLs and webhooks** and provide details as required. The URL format must be <u>https://www.example.com/</u>
  - **Base URL:** A fallback URL for failed transactions. The signer is redirected here if the process is terminated due to a failed Liveliness/Face Match check after all retry attempts, or a mismatch in the signer's certificate details.
  - **Redirect URL:** A destination URL for finalized transactions. The signer is directed here upon successfully signing the document, or explicitly rejecting the request to sign.
  - **Webhook:** Sends document-related payloads to a publicly accessible URL for real-time data integration.
  - **Error Webhook:** Provides detailed payloads for specific error scenarios, such as Aadhaar eSign retry limit exhaustion, certificate mismatch, or expired invitations.
  - **Webhook Version:** There are four webhook versions that can be selected from the drop-down.
3. Click **Save**.

**Note:** Within a reusable workflow, the workflow runner cannot disable this if enabled by the creator, and vice versa.

#### V4 Workflow

1. On the **Invite** stage, select the invitee card.
2. In the right panel, open the **Settings** tab and go to **Webhooks**.
3. Configure the custom **Webhook** and **URL** for real-time status updates. (**Note:** The URL format must be <u>https://www.example.com/</u>)
4. To customise the signing-journey URLs, go to **Manage Invitee Interactions** and set the **Base URL** and/or **Redirect URL**.

**Note:** Within a reusable workflow, whether the workflow runner can modify this setting depends on the [field properties](https://knowledge.leegality.com/document-execution/workflows/v4/setup-configuration/field-properties) set by the workflow creator.

> **Info — Note**
>
> The URL must not exceed 255 characters.

> **Info — Note**
>
> To know about custom webhook headers, [click here](https://docs.leegality.com/webhooks_resources)