Skip to main content

Pushover

The pushover trigger sends instant push notifications to Android, iOS, and desktop devices via the Pushover API.

⚙️ Configuration Variables​

WUD_TRIGGER_PUSHOVER_{trigger_name}_TOKEN
Requiredstring

Pushover Application API token

Allowed values:30-character Application API Token
WUD_TRIGGER_PUSHOVER_{trigger_name}_USER
Requiredstring

Pushover User Key (or Delivery Group Key)

Allowed values:30-character Pushover User Key
WUD_TRIGGER_PUSHOVER_{trigger_name}_DEVICE
Optionalstring

Target device name(s) (comma-separated, e.g. phone,tablet)

Allowed values:[Pushover device identifiers](https://pushover.net/api#identifiers)
WUD_TRIGGER_PUSHOVER_{trigger_name}_EXPIRE
Optionalinteger

Notification expiration time in seconds (only when priority=2)

Allowed values:Maximum 86400 seconds
WUD_TRIGGER_PUSHOVER_{trigger_name}_HTML
Optionalintegerdefault: 0

Enable HTML formatting in message body

Allowed values:`1` (enable HTML), `0` (plain text)
WUD_TRIGGER_PUSHOVER_{trigger_name}_PRIORITY
Optionalintegerdefault: 0

Notification priority level (-2: lowest, -1: quiet, 0: normal, 1: high, 2: emergency)

Allowed values:Integer between `-2` and `2` [see docs](https://pushover.net/api#priority)
WUD_TRIGGER_PUSHOVER_{trigger_name}_RETRY
Optionalinteger

Notification retry interval in seconds (only when priority=2)

Allowed values:Minimum 30 seconds
WUD_TRIGGER_PUSHOVER_{trigger_name}_SOUND
Optionalstringdefault: pushover

Notification alert sound

Allowed values:[Supported Pushover sounds](https://pushover.net/api#sounds)
WUD_TRIGGER_PUSHOVER_{trigger_name}_TTL
Optionalinteger

Message Time-to-Live in seconds

Allowed values:Seconds (e.g. `86400`)
info

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

🚀 Examples​

Basic Push Notification​

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_TRIGGER_PUSHOVER_LOCAL_USER=uQiRzpo4DXghDmr9QzzfQu27cmVRsG
      - WUD_TRIGGER_PUSHOVER_LOCAL_TOKEN=azGDORePK8gMaC0QOYAMyEEuzJnyUi

📖 Setup Guide: Obtaining Pushover Credentials​

  1. Log in to your Pushover Dashboard and copy your User Key (top right).
  2. Scroll down to Your Applications and click Create an Application / API Token.
  3. Name your application WUD and click Create Application.
  4. Copy the generated API Token and set it as WUD_TRIGGER_PUSHOVER_{trigger_name}_TOKEN.