Skip to main content

Webhooks

Webhooks can receive delivery events or provider callbacks where enabled for your organization.

Webhook Event Receiver​

POST your-webhook-url

Alerta sends event payloads to the URL configured for your organization or integration.

Example Payload​

{
  "event": "alert.delivered",
  "deliveryId": "del_example",
  "provider": "slack",
  "channelRef": "C_ALT_EXAMPLE"
}

Receiver Response​

Return a success status quickly after accepting the event.

HTTP/1.1 204 No Content

Implementation Guidance​

  • validate webhook signatures or shared secrets when configured
  • respond quickly with a success status after accepting the event
  • process expensive follow-up work asynchronously
  • store event IDs to make handlers idempotent