Skip to main content

​
Overview

The Incoming API integration gives you a unique webhook URL that any external system can POST alerts to. Warrn ingests the payload, maps fields to its alert schema, and routes the alert through the normal pipeline — triage, ownership, escalation. This is the most flexible way to connect monitoring tools, CI/CD pipelines, or custom applications that Warrn does not have a native integration for.

​
Setup

  1. Open a service in Warrn and go to Integrations.
  2. Add an Incoming API integration.
  3. Copy the generated webhook URL and key.
  4. Configure field mappings to tell Warrn how to extract alert name, description, severity, and metadata from your payload.

​
Field Mapping

Warrn supports configurable JSONPath-style field mappings so you can connect any payload structure:
  • Map $.alertname to the Warrn alert name.
  • Map $.message to the alert description.
  • Map $.level to the alert severity.
  • Add default values for fields your source does not provide.

​
How to Send Alerts

POST a JSON payload to your integration’s webhook URL: 
curl -X POST "https://api.warrn.io/api/integrations/webhook/{your_webhook_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "alertname": "High CPU Usage",
    "message": "CPU exceeded 90% on web-server-01",
    "level": "critical"
  }'

​
Type

Incoming — External systems push alerts into Warrn. Warrn does not send data back through this endpoint.