> **Source:** https://knowledge.leegality.com/document-execution/api/coordinate-picker-webhook
> **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 /your-webhook-endpoint/coordinate-picker — Coordinate Picker

Leegality sends this payload to the **Coordinate Picker Webhook URL** configured in the invitee-level options when eSign coordinates are successfully placed on the document.

**Authentication:** `X-Auth-Token` header required on every request.

## Request URL

```
WEBHOOK https://app1.leegality.com/api/your-webhook-endpoint/coordinate-picker
```

**Environments:**
- Production: `https://app1.leegality.com/api/your-webhook-endpoint/coordinate-picker`
- Sandbox: `https://sandbox.leegality.com/api/your-webhook-endpoint/coordinate-picker`

---

## Request Body

**Content-Type:** `application/json`

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `documentId` | string | No | The unique Leegality document ID for the eSigning request. | `01KJ4SVYM95J35XVVJAXDPA7JW` |
| `irn` | string | No | The Internal Reference Number passed in the original eSigning request. Returns `null` if no IRN was provided. | `123456` |
| `mac` | string | No | HMAC-SHA1 hash of the `documentId` computed with your Private Salt. Use this to verify the webhook is genuinely from Leegality. | `a9cb19205a780900d33acef52cbf86ae04b3023c` |
| `invitations` | array\<object\> | No | Array of invitee objects for this document. Each object represents one invitee with their updated signing URL and status after coordinate placement. See **invitations** below. | — |

#### invitations

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `name` | string | No | The full name of the invitee. | `John Doe` |
| `email` | string | No | The email address of the invitee. | `john@example.com` |
| `phone` | string | No | The phone number of the invitee. | `9876543210` |
| `signUrl` | string | No | The unique signing URL for this invitee, generated after coordinate placement. Share this URL with the invitee to proceed to signing. | `https://app1.leegality.com/sign/uuid-here` |
| `active` | boolean | No | Whether this invitation is currently active. | `true` |
| `expiryDate` | string | No | The expiry date and time of the invitation. | `07-03-2026 23:59:59` |

### Sample Request

```json
{
  "documentId": "01KJ4SVYM95J35XVVJAXDPA7JW",
  "irn": "123456",
  "mac": "a9cb19205a780900d33acef52cbf86ae04b3023c",
  "invitations": [
    {
      "name": "John Doe",
      "email": "john@example.com",
      "phone": "9876543210",
      "signUrl": "https://app1.leegality.com/sign/uuid-here",
      "active": true,
      "expiryDate": "07-03-2026 23:59:59"
    }
  ]
}
```

---

## 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.