Skip to main content

Notification Channels

Kamustatus supports 14 notification channel types. Configure channels via the Alerts API or the dashboard.

Channel Types​

1. Email​

{
  "type": "email",
  "config": {
    "address": "oncall@example.com"
  }
}

2. Slack​

{
  "type": "slack",
  "config": {
    "webhookUrl": "https://hooks.slack.com/services/T.../B.../xxx"
  }
}

3. Discord​

{
  "type": "discord",
  "config": {
    "webhookUrl": "https://discord.com/api/webhooks/123/abc"
  }
}

4. Microsoft Teams​

{
  "type": "teams",
  "config": {
    "webhookUrl": "https://outlook.office.com/webhook/..."
  }
}

5. PagerDuty​

{
  "type": "pagerduty",
  "config": {
    "integrationKey": "your-pagerduty-integration-key"
  }
}

6. Opsgenie​

{
  "type": "opsgenie",
  "config": {
    "apiKey": "your-opsgenie-api-key",
    "region": "us"
  }
}

7. Webhook​

Send alert payloads to any HTTP endpoint.

{
  "type": "webhook",
  "config": {
    "url": "https://example.com/webhook",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer token"
    }
  }
}

Webhook payload:

{
  "event": "monitor_down",
  "monitor": {
    "id": "mon_abc123",
    "name": "My API",
    "url": "https://api.example.com"
  },
  "timestamp": "2025-05-15T08:30:00Z",
  "details": {
    "statusCode": 503,
    "responseTime": 5000,
    "region": "eu-west"
  }
}

8. Telegram​

{
  "type": "telegram",
  "config": {
    "botToken": "123456:ABC-DEF...",
    "chatId": "-1001234567890"
  }
}

9. SMS​

{
  "type": "sms",
  "config": {
    "phoneNumber": "+1234567890"
  }
}

10. Phone Call​

{
  "type": "phone",
  "config": {
    "phoneNumber": "+1234567890"
  }
}

11. Pushover​

{
  "type": "pushover",
  "config": {
    "userKey": "your-pushover-user-key",
    "appToken": "your-pushover-app-token"
  }
}

12. Ntfy​

{
  "type": "ntfy",
  "config": {
    "topic": "your-topic",
    "serverUrl": "https://ntfy.sh"
  }
}

13. Google Chat​

{
  "type": "googlechat",
  "config": {
    "webhookUrl": "https://chat.googleapis.com/v1/spaces/.../messages?key=...&token=..."
  }
}

14. Matrix​

{
  "type": "matrix",
  "config": {
    "homeserverUrl": "https://matrix.org",
    "roomId": "!abc123:matrix.org",
    "accessToken": "your-matrix-access-token"
  }
}

Creating a Channel via API​

curl -X POST https://app.kamustatus.com/api/notification-channels \
  -H "x-api-key: km_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Slack Alerts",
    "type": "slack",
    "config": {
      "webhookUrl": "https://hooks.slack.com/services/T.../B.../xxx"
    }
  }'

Testing a Channel​

Send a test notification to verify the channel is configured correctly:

curl -X POST https://app.kamustatus.com/api/notification-channels/:channelId/test \
  -H "x-api-key: km_your_api_key"