Skip to content

Activate Notification Channel

POST/web/v1/notification-channels/command/activateWEB

Activates a notification channel, enabling it to send notifications.

Authentication

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

Request Parameters

Request Body

ChannelStatusRequest:

NameTypeRequiredInDescription
bizIdstringYesbodyChannel business ID to activate

Success Response

Success200
{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "ch_abc123",
    "institutionBizId": "inst_abc123",
    "channelName": "Main Email",
    "channelRemark": null,
    "channelHost": "smtp.example.com",
    "channelCategory": "EMAIL",
    "channelStatus": "ACTIVE",
    "emailConfig": {
      "smtpHost": "smtp.example.com",
      "smtpPort": 587,
      "senderEmail": "noreply@example.com",
      "senderName": "Acme Corp",
      "username": "noreply@example.com",
      "password": "******",
      "useSsl": true,
      "useStartTls": false,
      "connectionTimeout": 10000,
      "readTimeout": 30000
    },
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T01:00:00Z",
    "createdBy": "user_xyz",
    "updatedBy": "user_xyz"
  }
}

Error Responses

CodeDescription
4000Validation error (missing bizId)
4010Unauthorized (invalid or missing JWT token)
4030Turnstile verification failed
4040Channel not found

Notes

  • The channel status changes from its current state to ACTIVE.
  • The password in the email config is masked in the response.

Internal Documentation