Skip to main content
POST
/
notifications
/
channels
curl -X POST "https://kodostatus.com/api/v1/notifications/channels" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "slack",
    "name": "Engineering Alerts",
    "config": {
      "webhook_url": "https://hooks.slack.com/services/..."
    }
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "slack",
  "name": "Engineering Alerts",
  "enabled": true,
  "config": { "webhook_url": "https://hooks.slack.com/..." },
  "notify_on_incident": true,
  "notify_on_maintenance": true,
  "created_at": "2026-02-20T08:00:00.000Z",
  "updated_at": "2026-02-20T08:00:00.000Z"
}

​
Body Parameters

​
type
string
required
Channel type: slack, webhook, discord, teams, pagerduty, sms
​
name
string
required
Channel name
​
config
object
required
Channel-specific configuration (see examples below)
​
enabled
boolean
default:"true"
Whether the channel is active

​
Config by Type

{
  "webhook_url": "https://hooks.slack.com/services/..."
}

​
Response

Returns the created channel object. 
curl -X POST "https://kodostatus.com/api/v1/notifications/channels" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "slack",
    "name": "Engineering Alerts",
    "config": {
      "webhook_url": "https://hooks.slack.com/services/..."
    }
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "slack",
  "name": "Engineering Alerts",
  "enabled": true,
  "config": { "webhook_url": "https://hooks.slack.com/..." },
  "notify_on_incident": true,
  "notify_on_maintenance": true,
  "created_at": "2026-02-20T08:00:00.000Z",
  "updated_at": "2026-02-20T08:00:00.000Z"
}