guideDifficulty: beginnerTime: 20mVersion: v1Services: status, webhooksSDK: lawie-cliReviewed: 2025-01-18Reviewer: Docs PlatformTags: status, webhooks
Subscribe to Incident Webhooks
Receive incident updates automatically via webhook subscriptions.
Overview
Set up a webhook endpoint and subscribe to Lawie status events for operational awareness.
Prerequisites
- Public HTTPS endpoint for webhook deliveries
- API key with
status.readscope
Architecture Diagram
Events flow from Lawie status to your webhook processor and alerting system.
Steps
- Create a webhook endpoint in your system (
POST /status/v1/webhooks). - Configure event filters (
incident.created,incident.updated,incident.resolved). - Validate the signature header (
Lawie-Signature). - Persist incident updates to your on-call timeline.
API Calls Referenced
POST /status/v1/webhooksGET /status/v1/incidents
Troubleshooting
401→ API key missing or expired.422→ Payload validation failed; ensure your endpoint accepts JSON.