2024.11.0
Home ▸ Integrations ▸

Simplepush

The simplepush platform uses Simplepush to deliver notifications from Home Assistant to your Android and iOS device. Unlike similar apps the Simplepush app requires no registration and supports end-to-end encryption.

Configuration

To add the Simplepush integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Simplepush.

  • Follow the instructions on screen to complete the setup.

To test if the service works, just send a message with curl from the command-line.

curl 'https://simplepu.sh/YOUR_SIMPLEPUSH_KEY/message'

If you enter your password and salt (as defined in the Simplepush app settings) during the configuration of this integration, all notifications sent from this integration will be end-to-end encrypted.

Notifications

Simplepush can send a notification by calling the notify action.

You can specify the event under the data key. Events can be used to customize the notification behavior.

It is also possible to specify attachments under the data key. Attachments can be images, GIFs or video files that are accessible by a URL.

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

Examples

Send a notification with a title and event.

- action: notify.simplepush
    data:
      title: "This is the title"
      message: "This is the message"
      data:
        event: "event"

Send a notification with four attachments defined by their URL. Attachments can be images, GIFs or video files.

- action: notify.simplepush
    data:
      message: "This is the message"
      data:
        attachments:
          - image: "https://upload.wikimedia.org/wikipedia/commons/e/ee/Sample_abc.jpg"
          - image: "https://upload.wikimedia.org/wikipedia/commons/d/d3/Newtons_cradle_animation_book_2.gif"
          - video: "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
          - video: "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ElephantsDream.mp4"
            thumbnail: "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/images/ForBiggerEscapes.jpg"