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"
}
Notification Channels
Create Notification Channel
Create a new notification channel
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, smsstring
required
Channel name
object
required
Channel-specific configuration (see examples below)
boolean
default:"true"
Whether the channel is active
Config by Type
- Slack
- Discord
- Teams
- SMS
- PagerDuty
- Webhook
{
"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"
}