Custom Webhooks¶

Send alerts from any monitoring system to Robusta via HTTP webhooks.

Overview¶

Forward alerts from any system that can send HTTP POST requests. Robusta will automatically enrich these alerts with Kubernetes context and apply your automation rules.

Webhook Endpoint¶

Send alerts to Robusta using the following endpoint:

POST https://api.robusta.dev/api/alerts

Authentication¶

You'll need your API key and account ID:

1. Account ID: Found in your generated_values.yaml file

2. API Key: Generate this in the Robusta platform under Settings → API Keys → New API Key

For detailed API documentation including request format, authentication, and examples, see Alert History Import and Export API.

Quick Example¶

Here's a simple example of sending a custom alert:

curl --location --request POST 'https://api.robusta.dev/api/alerts' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "account_id": "YOUR_ACCOUNT_ID",
        "alerts": [
            {
                "title": "Test Service Down",
                "description": "The Test Service is not responding.",
                "source": "monitoring-system",
                "priority": "high",
                "aggregation_key": "test-service-issues"
            }
        ]
    }'

Next Steps¶

For complete API documentation including all available fields and response formats, see Alert History Import and Export API.