> **Source:** https://knowledge.leegality.com/sign-station/api/create-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 `<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

---
# POST /api/v1/notification-config — Create new notification configuration

Creates new notification configuration for the current user's organization

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

## Request URL

```
POST 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

### 201 — Notification configuration created 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 created 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\<ErrorDetailCreateNotificationConfig400VO\> | No | List of error details See **ErrorDetailCreateNotificationConfig400VO** below. | — |

#### ErrorDetailCreateNotificationConfig400VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Invalid value for field [fromEmail], From email must be a va` |
| `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\<ErrorDetail401Unauthorized\> | 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` |

### 409 — Configuration already exists for organization

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_409` |
| `errors` | array\<ErrorDetailCreateNotificationConfig409VO\> | No | List of error details See **ErrorDetailCreateNotificationConfig409VO** below. | — |

#### ErrorDetailCreateNotificationConfig409VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Notification configuration for organization 'TestOrganizatio` |
| `path` | string | No | API path that generated the error | `/api/v1/notification-config` |
| `code` | string | No | Specific error code | `LE_ERR_SS_010` |

### 500 — Internal server error

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_500` |
| `errors` | array\<ErrorDetailToken500VO\> | 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 (201)

```json
{
  "code": "LE_SCS_SS_200",
  "message": "Notification configuration created 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
  }
}
```