Skip to main content

Home Assistant (Webhook)

The Home Assistant Webhook trigger sends structured JSON payloads to Home Assistant automation webhooks whenever container updates are detected.

⚙️ Configuration Variables​

WUD_TRIGGER_HOMEASSISTANT_{trigger_name}_URL
Requiredurl

Home Assistant incoming webhook URL

Allowed values:Valid HTTP/HTTPS Home Assistant webhook URL (e.g. http://homeassistant.local:8123/api/webhook/YOUR_WEBHOOK_ID)
WUD_TRIGGER_HOMEASSISTANT_{trigger_name}_DISABLETITLE
Optionalbooleandefault: false

Whether to omit the notification title in payload

WUD_TRIGGER_HOMEASSISTANT_{trigger_name}_EVENT
Optionalstringdefault: wud_container_update

Custom event name included in the webhook payload

info

This trigger also supports all common trigger configuration options (such as thresholds, scheduling, and batching).

📦 Webhook Payload Format​

When a container update occurs, WUD sends an HTTP POST request with Content-Type: application/json:

{
  "event": "wud_container_update",
  "mode": "simple",
  "title": "New tag found for container nginx",
  "message": "Container nginx running with tag 1.24 can be updated to tag 1.25",
  "container": {
    "name": "nginx",
    "watcher": "local",
    "image": {
      "name": "nginx",
      "tag": { "value": "1.24", "semver": true }
    },
    "result": {
      "link": "https://hub.docker.com/_/nginx"
    }
  }
}

🚀 Examples​

Basic Webhook Automation​

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_TRIGGER_HOMEASSISTANT_HA_URL=http://homeassistant.local:8123/api/webhook/wud_container_update_hook
      - WUD_TRIGGER_HOMEASSISTANT_HA_EVENT=wud_container_update