Pushbullet

The pushbullet notification platform sends messages to Pushbullet, a free service to send information between your phones, browsers, and friends.

To enable Pushbullet notifications in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME
    platform: pushbullet
    api_key: YOUR_API_KEY

Configuration variables:

• api_key (Required): Enter the API key for Pushbullet. Go to https://www.pushbullet.com/#settings/account to retrieve your API key/access token.
• name (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is notify. The notifier will bind to the service notify.NOTIFIER_NAME.

Usage

Pushbullet is a notify platform and thus can be controlled by calling the notify service as described here. It will send a notification to all devices registered in the Pushbullet account. An optional target parameter can be given to Pushbullet to specify specific account’s devices, contacts or channels.

If using targets, your own account’s email address functions as ‘send to all devices’. All targets are verified (if exists) before sending, except email.

Example service payload

{
  "message": "A message for many people",
  "target": [
    "device/telephone",
    "email/hello@example.com",
    "channel/my_home"
  ]
}

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

URL support

action:
  service: notify.NOTIFIER_NAME
  data:
    title: Send URL
    message: This is an url
    data:
      url: google.com

• url (Required): Page URL to send with Pushbullet.

File support

action:
  service: notify.NOTIFIER_NAME
  data:
    title: Send file
    message: This is a file
    data:
      file: /path/to/my/file

• file (Required): File to send with Pushbullet.

File URL support

action:
  service: notify.NOTIFIER_NAME
  data:
    title: Send file
    message: This is a file URL
    data:
      file_url:  https://cdn.pixabay.com/photo/2014/06/03/19/38/test-361512_960_720.jpg

• file_url (Required): File to send with Pushbullet.

Don’t forget to whitelist external directories, so Home Assistant has access to them.