Skip to main content
POST
/
webhooks
curl -X POST "https://kodostatus.com/api/v1/webhooks" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Incident Alerts",
    "url": "https://example.com/webhook",
    "events": ["incident.created", "incident.updated", "incident.resolved"],
    "secret": "whsec_..."
  }'

{
  "id": "uuid",
  "name": "Incident Alerts",
  "url": "https://example.com/webhook",
  "events": ["incident.created", "incident.updated", "incident.resolved"],
  "enabled": true,
  "secret": "whsec_..."
}

​
Body Parameters

​
name
string
required
Webhook name
​
url
string
required
Endpoint URL
​
events
array
Events to subscribe to:
  • incident.created
  • incident.updated
  • incident.resolved
  • service.status_changed
  • monitor.down
  • monitor.recovered
​
secret
string
Signing secret for webhook verification

​
Response

Returns the created webhook object including the secret. 
curl -X POST "https://kodostatus.com/api/v1/webhooks" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Incident Alerts",
    "url": "https://example.com/webhook",
    "events": ["incident.created", "incident.updated", "incident.resolved"],
    "secret": "whsec_..."
  }'

{
  "id": "uuid",
  "name": "Incident Alerts",
  "url": "https://example.com/webhook",
  "events": ["incident.created", "incident.updated", "incident.resolved"],
  "enabled": true,
  "secret": "whsec_..."
}