> **Source:** https://knowledge.leegality.com/sign-station/api/update-config > **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 --- # PUT /api/v1/notification-config — Update notification configuration Updates notification configuration for the current user's organization **Authentication:** `X-Auth-Token` header required on every request. ## Request URL ``` PUT https://app1.leegality.com/api/api/v1/notification-config ``` **Environments:** - Production: `https://app1.leegality.com/api/api/v1/notification-config` - Sandbox: `https://sandbox.leegality.com/api/api/v1/notification-config` --- ## Request Body **Content-Type:** `application/json` Notification configuration data to create | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `emailServerHost` | string | Yes | Email server host address | `smtp.example.com` | | `emailServerPort` | string | No | Email server port | `587` | | `username` | string | No | Username for email server authentication | `anagha.babu@leegality.com` | | `password` | string | No | Password for email server authentication | `NewPassword@123` | | `fromEmail` | string | No | Email address used in the 'From' field of outgoing emails | `testuser@leegality.com` | | `fromName` | string | No | Name used in the 'From' field of outgoing emails | `Leegality Test User` | | `replyTo` | string | No | Email address used in the 'Reply-To' field of outgoing emails | `testuser@leegality.com` | | `tlsEnabled` | boolean | No | Indicates whether TLS is enabled for email communication | `true` | | `enabled` | boolean | No | Indicates whether the notification configuration is enabled | — | ### Sample Request ```json { "emailServerHost": "smtp.example.com", "emailServerPort": "587", "username": "anagha.babu@leegality.com", "password": "NewPassword@123", "fromEmail": "testuser@leegality.com", "fromName": "Leegality Test User", "replyTo": "testuser@leegality.com", "tlsEnabled": true, "enabled": false } ``` --- ## Responses ### 200 — Notification configuration updated successfully | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Response code indicating success or failure | `LE_SCS_SS_200` | | `message` | string | No | Response message providing additional information | `Notification configuration updated successfully` | | `data` | NotificationConfigVO | No | See **NotificationConfigVO** below. | — | #### NotificationConfigVO | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `id` | string | No | Notification configuration unique identifier | `5e191ba4-3fe5-4dd4-ba7c-f2e9632c08c2` | | `emailServerHost` | string | No | Email server host address | `smtp.gmail.com` | | `emailServerPort` | string | No | Email server port | `587` | | `username` | string | No | Username for email server authentication | `himanshu.kumar@leegality.com` | | `password` | string | No | Password for email server authentication | `NewPassword@123` | | `fromEmail` | string | No | Email address used in the 'From' field of outgoing emails | `himanshu.kumar@leegality.com` | | `fromName` | string | No | Name used in the 'From' field of outgoing emails | `Himanshu Kumar` | | `replyTo` | string | No | Email address used in the 'Reply-To' field of outgoing emails | `himanshu.kumar@leegality.com` | | `tlsEnabled` | boolean | No | Indicates whether TLS is enabled for email communication | `true` | | `createdAt` | string | No | The date and time when the notification configuration was created | `2025-10-10T15:42:45` | | `enabled` | boolean | No | Indicates whether the notification configuration is enabled | `false` | ### 400 — Invalid request data | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_400` | | `errors` | array\ | No | List of error details See **ErrorDetailUpdateNotificationConfig400VO** below. | — | #### ErrorDetailUpdateNotificationConfig400VO | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `Invalid value for field [replyTo], Reply to must be a valid ` | | `path` | string | No | API path that generated the error | `/api/v1/notification-config` | ### 401 — Unauthorized - Invalid or expired token | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_401` | | `errors` | array\ | No | List of error details See **ErrorDetail401Unauthorized** below. | — | #### ErrorDetail401Unauthorized | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `Invalid or expired token` | | `path` | string | No | API path that generated the error | `/api/v1/*` | | `code` | string | No | Specific error code | `LE_ERR_SS_303` | ### 404 — Configuration not found | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_404` | | `errors` | array\ | No | List of error details See **ErrorDetailUpdateNotificationConfig404VO** below. | — | #### ErrorDetailUpdateNotificationConfig404VO | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `Configuration not found.` | | `path` | string | No | API path that generated the error | `/api/v1/notification-config` | | `code` | string | No | Specific error code | `LE_ERR_SS_1301` | ### 500 — Internal server error | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_500` | | `errors` | array\ | No | List of error details See **ErrorDetailToken500VO** below. | — | #### ErrorDetailToken500VO | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `Internal Server Error` | | `path` | string | No | API path that generated the error | `null` | | `code` | string | No | Specific error code | `null` | ### Sample Response (200) ```json { "code": "LE_SCS_SS_200", "message": "Notification configuration updated successfully", "data": { "id": "5e191ba4-3fe5-4dd4-ba7c-f2e9632c08c2", "emailServerHost": "smtp.gmail.com", "emailServerPort": "587", "username": "himanshu.kumar@leegality.com", "password": "NewPassword@123", "fromEmail": "himanshu.kumar@leegality.com", "fromName": "Himanshu Kumar", "replyTo": "himanshu.kumar@leegality.com", "tlsEnabled": true, "createdAt": "2025-10-10T15:42:45", "enabled": false } } ```