Webhooks

Configure webhook endpoints to send event notifications to external services. Webhooks can deliver alerts, deployment events, and container status changes to Slack, Discord, Microsoft Teams, or any custom HTTP endpoint.

INFO

Webhooks require a Pro license. See Licensing for details.

Access

Navigate to Settings > Webhooks in the sidebar.

Key Features

• Send notifications to Slack, Discord, Microsoft Teams, or custom URLs
• Trigger on alert events, deployments, and container state changes
• Per-webhook event type filtering
• Delivery history with success/failure status
• Test webhook connectivity before saving

Usage

Adding a Webhook

1. Go to Settings > Webhooks and click Add Webhook
2. Select a type:

Type	URL Format
Slack	Slack incoming webhook URL
Discord	Discord webhook URL
Microsoft Teams	Teams incoming webhook URL
Custom	Any HTTP/HTTPS endpoint

3. Paste the endpoint URL
4. Select which event types should trigger this webhook
5. Click Test to send a test payload
6. Save the webhook

Event Types

Event	Description
alert.triggered	An alert rule threshold was exceeded
alert.resolved	An alert returned to normal
deployment.started	A deployment began
deployment.completed	A deployment finished successfully
deployment.failed	A deployment failed
container.started	A container was started
container.stopped	A container was stopped

Delivery History

Each webhook tracks its recent deliveries. View the history to see:

• Timestamp and event type
• HTTP status code returned
• Response time
• Payload sent

Failed deliveries are highlighted and can be retried manually.

API

GET    /api/webhooks                # List all webhooks
POST   /api/webhooks                # Create a webhook
PUT    /api/webhooks/{id}           # Update a webhook
DELETE /api/webhooks/{id}           # Delete a webhook
POST   /api/webhooks/{id}/test      # Send a test payload
GET    /api/webhooks/{id}/deliveries # View delivery history

Managed by WebhookController.