---
id: pushbullet
label: Pushbullet
title: Pushbullet - Actions
type: action
description: "The Pushbullet action allows you to notify iOS, Android & Windows 10 Phone & Desktop devices of a message using the Pushbullet API web service."
source: https://github.com/openhab/openhab1-addons/blob/master/bundles/action/org.openhab.action.pushbullet/README.md
since: 1x
logo: images/addons/pushbullet.png
install: auto
---

<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->

{% include base.html %}

# Pushbullet Actions

The Pushbullet action allows you to notify iOS, Android & Windows 10 Phone & Desktop devices of a message using the Pushbullet API web service.

## Configuration

You may define default values for parameters to action calls in the file `services/pushbullet.cfg`.
To override the default values, specify configuration parameters in the action call (using `Action override`).

| Property            | Default | Required                        | Action override       | Description                                                                                                   |
|---------------------|---------|:-------------------------------:|-----------------------|---------------------------------------------------------------------------|
| accesstoken         |         | Yes                             | -                     | Pushbullet [API token](#obtaining-an-api-key) to send to devices       |
| devicename          | DEFAULT | No                              |  botname              | The name of the openHAB bot                                               |
| defaultreceiver     |         | No                              | receiver              | The name of the Recipient                                                 |
| bots                |         | No                              | -                     | Comma-separated list of multiple bots, each with its own settings below.  |
| `<bot>`.devicename  |         | Yes, if using multiple bots     | botname               | Device name for a single bot                                               |
| `<bot>`.accesstoken |         | Yes, if using multiple bots     | -                                       | API token for a single bot                               |

### Example Configurations
Minimal (required):

```
accesstoken=<API token>
```

Extended setup with 2 bots, each with its own access token (optional):

```
bots=bot1,bot2
bot1.devicename=openHAB-foobar
bot1.accesstoken=1234abc
bot2.devicename=openHAB-tralala
bot2.accesstoken=4711qwert
```

## Actions

The following is a valid action call that can be made when the plugin is loaded.
For specific information on each item, see the [Pushbullet API](https://docs.pushbullet.com/).
The recipient can either be an email address or a channel tag.
If it is not specified or invalid, the note will be broadcast to all of the user account's devices.

- `sendPushbulletNote(String title, String message)`
- `sendPushbulletNote(String receiver, String title, String message)`
- `sendPushbulletNote(String botname, String receiver, String title, String message)`

## Examples

```java
sendPushbulletNote("mybot", "someone@somewhere.com", "this is the title", "And this is the body of the message")
```

## Creating an account for your bot(s)

The pushbullet accounts are bound to either Google or Facebook accounts.

- Go to "<https://www.pushbullet.com/>"
- Chose to either "Sign up with Google" or "Sign up with Facebook".
- Complete the signup process as guided by the pushbullet web site.
- Continue with "Obtaining an API key".

## Obtaining an API key

The API keys are bound to the pushbullet account.

- Go to the pushbullet site.
- Log in with either your personal account or the one you created for your bot.
- Go to "<https://www.pushbullet.com/#settings/account>"
- Click on "Create Access Token".
- Copy the token created on the site.

You must at least provide an API token (Private or Alias Key from Pushbullet.com) and a message in some manner before a message can be pushed.
All other parameters are optional.
If you use an alias key, the parameters (device, icon, sound, vibration) are overwritten by the alias setting on pushbullet.

## Rate limits

As of June 2017, free accounts have a limit of 500 pushes per month.
This action does not evaluate the rate limiting headers though.

## Libraries

This action has been written without using libraries as jpushbullet or jpushbullet2.
Both of those libraries use various libraries themselves which makes integrating them into openHAB a challenge.

## pushbullet API

- <https://docs.pushbullet.com/>
- <https://docs.pushbullet.com/#push-limit>