Create Notification Channel

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"
}

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

string

required

Channel type: slack, webhook, discord, teams, pagerduty, sms

string

required

Channel name

object

required

Channel-specific configuration (see examples below)

boolean

default:"true"

Whether the channel is active

Config by Type

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

{
  "webhook_url": "https://discord.com/api/webhooks/..."
}

{
  "webhook_url": "https://outlook.office.com/webhook/..."
}

{
  "phone_number": "+1234567890"
}

{
  "routing_key": "your_pagerduty_integration_key"
}

{
  "url": "https://your-server.com/webhook",
  "secret": "optional_signing_secret"
}

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"
}

List Notification Channels Get Channel

Overview

Status Pages

Status Page Design

Incidents

Services

Uptime Monitors

SSL Monitors

Domain Monitors

Heartbeat

Metrics

Notification Channels

Webhooks

Error Tracking

Releases

Source Maps

Maintenance

Configuration

Workflows

API Keys

Audit Log

Beacon

Create Notification Channel

Body Parameters

Config by Type

Response

​Body Parameters

​Config by Type

​Response

Body Parameters

Config by Type

Response