Notification Channels
Manage notification channels for alerts.
Notification channels send alerts via Discord webhooks or email when events occur.
List Channels
GET
/api/v1/notificationsAuthenticatedcurl https://unstatus.app/api/v1/notifications \
-H "Authorization: Bearer usk_your_key"{
"data": [
{
"id": "nc_...",
"name": "Engineering Discord",
"type": "discord",
"webhookUrl": "https://discord.com/api/webhooks/...",
"enabled": true,
"onMonitorDown": true,
"onMonitorRecovered": true,
"onIncidentCreated": true,
"onIncidentResolved": true,
"onIncidentUpdated": true,
"onMaintenanceScheduled": true,
"onMaintenanceStarted": true,
"onMaintenanceCompleted": true
}
],
"pagination": { "total": 1, "limit": 20, "offset": 0, "hasMore": false }
}Create Channel
POST
/api/v1/notificationsAuthenticated| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Channel name |
type | string | Yes | discord or email |
webhookUrl | string | Discord | Discord webhook URL |
recipientEmail | string | Comma-separated emails | |
onMonitorDown | boolean | No | Alert on monitor down (default true) |
onMonitorRecovered | boolean | No | Alert on recovery (default true) |
onIncidentCreated | boolean | No | Alert on new incident (default true) |
onIncidentResolved | boolean | No | Alert on resolution (default true) |
onIncidentUpdated | boolean | No | Alert on updates (default true) |
onMaintenanceScheduled | boolean | No | Alert on scheduled maintenance (default true) |
onMaintenanceStarted | boolean | No | Alert on maintenance start (default true) |
onMaintenanceCompleted | boolean | No | Alert on completion (default true) |
curl -X POST https://unstatus.app/api/v1/notifications \
-H "Authorization: Bearer usk_your_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Engineering Discord",
"type": "discord",
"webhookUrl": "https://discord.com/api/webhooks/..."
}'Update Channel
PATCH
/api/v1/notifications/:idAuthenticatedDelete Channel
DELETE
/api/v1/notifications/:idAuthenticated