Webhooks

Weather webhook delivery

Sent to your HTTPS endpoint when a weather alert is issued for the location or a condition you set becomes true or clears. Set up on https://www.weatherapi.com/my/webhooks (Pro+: 5, Business: 20, High Volume and Enterprise: 50). Header X-WeatherAPI-Signature: t=<unix>,v1=<hex HMAC-SHA256 of t + "." + raw body with the webhook secret>; X-WeatherAPI-Event and X-WeatherAPI-Delivery carry the type and event id. Answer 2xx within 10 seconds; otherwise retried after 1, 5, 15, 60 and 180 minutes.

postWebhookweatherEvent

Payload

idstring
type'weather.alert' | 'weather.condition' | 'weather.condition.cleared' | 'ping'
createdstring date-time

Example payload

{
  "id": "evt_3f1c9a0b2d4e6f708192",
  "condition": {
    "metric": "gust_kph"
  }
}

Response

Any 2xx acknowledges the delivery.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.