Create Channel Type

POST/web/v1/notification-channel-types/command/createWEB

Creates a new notification channel type definition.

Authentication

Requires a valid JWT token and Turnstile verification. Gateway validation: enableJwtToken=true, enableTurnstile=true.

Request Parameters

Request Body

NotificationChannelTypeCreateRequest:

Name	Type	Required	In	Description
channelCategory	string	Yes	body	Channel category enum: EMAIL
typeName	string	Yes	body	Type display name (max 128 characters)
typeDescription	string	No	body	Type description (max 512 characters)
displayOrder	integer	No	body	Display sort order (default: 0)
iconUrl	string	No	body	Icon URL (max 512 characters)
extraConfig	string	No	body	Extra configuration as JSON string

Success Response

Success200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "ct_abc123",
    "typeCode": "EMAIL",
    "typeValue": 80010101,
    "typeName": "Email Notification",
    "typeDescription": "Standard email delivery",
    "typeStatus": "ENABLED",
    "displayOrder": 0,
    "iconUrl": null,
    "extraConfig": null,
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T00:00:00Z"
  }
}

Error Responses

Code	Description
4000	Validation error (missing required fields)
4010	Unauthorized (invalid or missing JWT token)
4030	Turnstile verification failed

Notes

• The typeCode and typeValue are derived from the channelCategory enum.
• Channel types are created with ENABLED status by default.