> **Source:** https://knowledge.leegality.com/sign-station/api/create-config-1
> **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/certificate-notification-config — Create new certificate notification configuration

Creates new certificate 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/certificate-notification-config
```

**Environments:**
- Production: `https://app1.leegality.com/api/api/v1/certificate-notification-config`
- Sandbox: `https://sandbox.leegality.com/api/api/v1/certificate-notification-config`

---

## Request Body

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

Certificate notification configuration data to create

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `reminderDays` | array\<integer\> | No | Days before expiry to send reminders | `2` |
| `additionalEmailRecipients` | array\<string\> | No | Additional email recipients for notifications | `anagha.babu@leegality.com` |
| `notifyRoleIds` | array\<string\> | No | Role IDs to be notified | `17d7949d-6fa9-4077-a76e-da349efe421b` |
| `enabled` | boolean | No | Indicates whether the certificate notification is enabled | `true` |

### Sample Request

```json
{
  "reminderDays": [
    2
  ],
  "additionalEmailRecipients": [
    "anagha.babu@leegality.com"
  ],
  "notifyRoleIds": [
    "17d7949d-6fa9-4077-a76e-da349efe421b"
  ],
  "enabled": true
}
```

---

## Responses

### 201 — Certificate notification configuration created successfully

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Response status code | `LE_SS_001` |
| `message` | string | No | Response message | `Your changes have been successfully saved.` |
| `data` | CertificateNotificationConfigVO | No | See **CertificateNotificationConfigVO** below. | — |

#### CertificateNotificationConfigVO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `id` | string | No | Certificate notification configuration unique identifier | `6d8ff341-fe21-431e-9453-bb94959474b6` |
| `reminderDays` | array\<integer\> | No | Days before expiry to send reminders | `2` |
| `additionalEmailRecipients` | array\<string\> | No | Additional email recipients for notifications | `anagha.babu@leegality.com` |
| `enabled` | boolean | No | Indicates whether the certificate notification is enabled | `true` |
| `createdAt` | string | No | The date and time when the certificate notification configuration was created | `2025-12-29T12:00:29.726603` |
| `notifyRoles` | array\<NotificationRoleVO\> | No | See **NotificationRoleVO** below. | — |

##### NotificationRoleVO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `id` | string | No | Role ID. This is configured during the role creation. | `17d7949d-6fa9-4077-a76e-da349efe421b` |
| `name` | string | No | Role name. E.g., "Admin", "User" etc. | `Test Role 12344` |
| `createdAt` | string | No | The date and time when the role was created | `2025-11-13T14:05:34` |

### 400 — Invalid request data

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

#### ErrorDetailCreateCertificateNotificationConfig400VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Invalid value for field [additionalEmailRecipients], Invalid` |
| `path` | string | No | API path that generated the error | `/api/v1/certificate-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` |

### 404 — Role does not exist

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

#### ErrorDetailCreateCertificateNotificationConfig404VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Role does not exist.` |
| `path` | string | No | API path that generated the error | `/api/v1/certificate-notification-config` |
| `code` | string | No | Specific error code | `LE_ERR_SS_001` |

### 409 — Configuration already exists for organization

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

#### ErrorDetailCreateCertificateNotificationConfig409VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Certificate notification configuration already exists for or` |
| `path` | string | No | API path that generated the error | `/api/v1/certificate-notification-config` |
| `code` | string | No | Specific error code | `LE_ERR_SS_1202` |

### 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_SS_001",
  "message": "Your changes have been successfully saved.",
  "data": {
    "id": "6d8ff341-fe21-431e-9453-bb94959474b6",
    "reminderDays": [
      2
    ],
    "additionalEmailRecipients": [
      "anagha.babu@leegality.com"
    ],
    "enabled": true,
    "createdAt": "2025-12-29T12:00:29.726603",
    "notifyRoles": [
      {
        "id": "17d7949d-6fa9-4077-a76e-da349efe421b",
        "name": "Test Role 12344",
        "createdAt": "2025-11-13T14:05:34"
      }
    ]
  }
}
```