---
title: "PerryWeather Webhooks (v1.2)"
url: "https://developers.perryweather.com/apis/perry-weather-webhooks-1/versions/aee3a2cd-955e-467b-98c4-51fddb573453"
---

# PerryWeather Webhooks (v1.2)

OpenAPI specification document.

```json
{"openapi":"3.1.0","info":{"title":"PerryWeather Webhooks (v1.2)","version":"1.2","description":"Outbound webhook events sent by PerryWeather using schema version 1.2.\n\nSignature header behavior:\n- Header: `x-pw-signature`\n- Algorithm: base64(HMAC-SHA256)\n- Signed value: exact raw JSON request body bytes\n\nNotes:\n- If key material is unavailable, `x-pw-signature` may be omitted.\n"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","webhooks":{"policyTrigger":{"post":{"summary":"v1.2 weather policy webhook","description":"Version 1.2 policy-trigger payload with body-based signature.\n","parameters":[{"in":"header","name":"x-pw-signature","required":false,"schema":{"type":"string"},"description":"base64(HMAC-SHA256) signature over the raw JSON body."}],"requestBody":{"required":true,"description":"Verify `x-pw-signature` against the raw request body when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"},"examples":{"delay":{"summary":"DELAY event example","value":{"event_id":"b6e2ea4d-358f-4c7c-b76d-9dd1aa2afbf7","event_type":"DELAY","time":"2026-01-12T19:15:12.401Z","version":"1.2","payload":{"customer_id":14925,"location_id":"1a8ae46f-ad78-4f44-907e-37043c68bd72","location_name":"Wichita, KS","policy_trigger_id":"2ee204fd-6546-4be8-99eb-165bf90efa13","condition_type":"LR1","message":"Lightning strike 12.4 miles from Wichita, KS.","additional_message":"Seek shelter immediately!","value":12.4,"value_units":"mi","event_type":"DELAY","event_id":"b6e2ea4d-358f-4c7c-b76d-9dd1aa2afbf7","policy":{"type":"LR1","threshold":15,"threshold_units":"mi","all_clear_minutes":30}}}},"all_clear":{"summary":"ALL_CLEAR event example","value":{"event_id":"3a690ff9-79cb-440e-b99b-00ba7396eba7","event_type":"ALL_CLEAR","time":"2025-07-18T11:37:08.8356934Z","version":"1.2","payload":{"customer_id":14925,"location_id":"1a8ae46f-ad78-4f44-907e-37043c68bd72","location_name":"Wichita, KS","policy_trigger_id":"777f2a11-4eef-4d7a-b12e-4a705178c5ca","condition_type":"LR1","message":"30 minute all clear, 15 miles from Wichita, KS.","additional_message":null,"value":0,"value_units":"mi","event_type":"ALL_CLEAR","event_id":"3a690ff9-79cb-440e-b99b-00ba7396eba7","policy":{"type":"LR1","threshold":15,"threshold_units":"mi","all_clear_minutes":30}}}}}}}},"responses":{"2XX":{"description":"Receiver accepted webhook"}}}}},"components":{"schemas":{"WebhookEvent":{"type":"object","required":["event_id","event_type","time","version","payload"],"properties":{"event_id":{"type":"string"},"event_type":{"type":"string","enum":["DELAY","ALL_CLEAR"]},"time":{"type":"string","format":"date-time"},"version":{"type":"string","enum":["1.2"]},"payload":{"$ref":"#/components/schemas/PolicyTriggerPayload"}}},"PolicyTriggerPayload":{"type":"object","required":["customer_id","location_id","location_name","policy_trigger_id","condition_type","message","additional_message","value","value_units","event_type","event_id","policy"],"properties":{"customer_id":{"type":"integer"},"location_id":{"type":"string"},"location_name":{"type":"string"},"policy_trigger_id":{"type":"string","format":"uuid"},"condition_type":{"type":"string"},"message":{"type":"string"},"additional_message":{"type":["string","null"]},"value":{"type":"number"},"value_units":{"type":"string"},"event_type":{"type":"string","enum":["DELAY","ALL_CLEAR"]},"event_id":{"type":"string"},"policy":{"$ref":"#/components/schemas/TriggeredPolicy"}}},"TriggeredPolicy":{"type":"object","required":["type","threshold","threshold_units","all_clear_minutes"],"properties":{"type":{"type":"string"},"threshold":{"type":"number"},"threshold_units":{"type":"string"},"all_clear_minutes":{"type":"integer"}}}}}}
```