Pushover

The Pushover service is a platform for the notify component. This allows integrations to send messages to the user using Pushover.

Configuration

In order to get an API key you need to register an application on the Pushover website. Your Pushover user key can be found on the Pushover dashboard.

Configuration

Adding Pushover to your Home Assistant instance can be done via the user interface, by using this My button:

Example Automation:

- service: notify.entity_id
  data:
    message: "This is the message"
    title: "Title of message"
    data:
      url: "https://www.home-assistant.io/"
      sound: pianobar
      priority: 0
      attachment: "local/image.png"

Component specific values in the nested data section are optional.

Image attachments can be added using the attachment parameter, which can either be a local file reference (ex: /tmp/image.png).

To use a specific Pushover device, set it using target. If one of the entered devices doesn’t exist or is disabled in your Pushover account it will send a message to all you devices. To send to all devices, just skip the target attribute.

- service: notify.entity_id
  data:
    message: "This is the message"
    title: "Title of message"
    target:
      - pixel3
      - pixel4a
    data:
      sound: pianobar
      priority: 0

To use the highest priority, which repeats the notification every x seconds (retry) for the duration of y seconds (expire), you MUST specify these parameters. The minimal time for the retry parameter is 30 seconds. The expire parameter has a maximum of 10800 seconds (3 hours). If you target more than one device, make sure to enable the advanced option “Notification dismissal sync” in the app to be able to dismiss the alert on all devices simultaneously.

- service: notify.entity_id
  data:
    message: "This is the message"
    title: "Title of message"
    target:
      - iphone11pro
    data:
      priority: 2
      sound: "siren"
      expire: 300
      retry: 30

To use notifications, please see the getting started with automation page.

When sending a notification, optional parameters can also be set as per the Pushover API documentation.

Example notification triggered from the Alexa integration for an intents is shown below which also uses Automation Templating for the message:

# Example configuration.yaml entries
alexa:
  intents:
    LocateIntent:
      action:
        service: notify.notify
        data:
          message: "The location of {{ User }} has been queried via Alexa."
        data:
          title: "Home Assistant"
          target: pixel
          data:
            sound: falling
            url: "https://www.home-assistant.io/"
            attachment: "/tmp/image.png"