Skip to main content
Notification channels determine how you receive alerts about incidents, monitor failures, and other events.

Supported Channels

ChannelUse Case
SlackTeam notifications in channels
DiscordCommunity and team alerts
EmailOn-call and subscriber notifications
PagerDutyIncident management and escalation
OpsGenieOn-call scheduling and alerts
Microsoft TeamsEnterprise team notifications
WebhookCustom integrations

Setting Up Slack

  1. Create a Slack incoming webhook:
    • Go to api.slack.com/apps
    • Create an app → Incoming Webhooks → Add to channel
    • Copy the webhook URL
  2. Add to Kodo:
    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/..."
        }
      }'
    

Setting Up Discord

  1. In your Discord server:
    • Right-click channel → Edit Channel → Integrations → Webhooks
    • Create Webhook → Copy URL
  2. Add to Kodo:
    curl -X POST "https://kodostatus.com/api/v1/notifications/channels" \
      -H "X-API-Key: your_api_key" \
      -d '{
        "type": "discord",
        "name": "Status Alerts",
        "config": {
          "webhook_url": "https://discord.com/api/webhooks/..."
        }
      }'
    

Setting Up Email

curl -X POST "https://kodostatus.com/api/v1/notifications/channels" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "type": "email",
    "name": "On-call Team",
    "config": {
      "emails": ["[email protected]", "[email protected]"]
    }
  }'

Setting Up PagerDuty

  1. In PagerDuty:
    • Go to Services → Select Service → Integrations
    • Add Integration → Events API v2
    • Copy the Integration Key
  2. Add to Kodo:
    curl -X POST "https://kodostatus.com/api/v1/notifications/channels" \
      -H "X-API-Key: your_api_key" \
      -d '{
        "type": "pagerduty",
        "name": "On-call",
        "config": {
          "routing_key": "your_integration_key"
        }
      }'
    

Testing Channels

Always test new channels:
curl -X POST "https://kodostatus.com/api/v1/notifications/channels/ch_abc123/test" \
  -H "X-API-Key: your_api_key"

Notification Events

Choose which events trigger notifications:
EventDescription
incident.createdNew incident created
incident.updatedIncident status changed
incident.resolvedIncident resolved
service.status_changedService status updated
monitor.downMonitor detected downtime
monitor.recoveredMonitor back online
ssl.expiringSSL certificate expiring soon
domain.expiringDomain registration expiring

Channel Priorities

Configure notification urgency per channel:
  • Critical - PagerDuty, phone calls
  • High - Slack #incidents, email
  • Normal - Slack #status, Discord
  • Low - Email digest