> For the complete documentation index, see [llms.txt](https://docs.toolhouse.ai/toolhouse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolhouse.ai/toolhouse/integrations/pushbullet.md).

# Pushbullet

Your Toolhouse AI Worker can connect to Pushbullet using 15 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=pushbullet).

## Tools (15)

### `Pushbullet Create Chat`

Integration name: **PUSHBULLET\_CREATE\_CHAT**

Tool to create a new chat with the specified email address. Use when you need to initiate a conversation thread by email.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                    | Description                                                                          |
| --------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------------------------ |
| `email`   | string |     ✅    | `"carmack@idsoftware.com"` | Email of the person to create the chat with (does not have to be a Pushbullet user). |

***

### `Pushbullet Create Device`

Integration name: **PUSHBULLET\_CREATE\_DEVICE**

Tool to register a new device under the current user's account. Use when adding a new hardware or app device to Pushbullet.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                                         | Description                                                          |
| -------------- | ------- | :------: | ----------------------------------------------- | -------------------------------------------------------------------- |
| `icon`         | string  |          | `"ios"`                                         | Icon for this device; e.g., desktop, phone, watch, etc.              |
| `model`        | string  |     ✅    | `"iPhone 5s (GSM)"`                             | Model of the device                                                  |
| `has_sms`      | boolean |          | `true`                                          | True if the device has SMS capability (Android only)                 |
| `nickname`     | string  |     ✅    | `"Elon Musk's iPhone"`                          | Name to display for the device                                       |
| `push_token`   | string  |          | `"production:abcdef1234567890abcdef1234567890"` | Platform-specific push token; leave blank for custom devices         |
| `app_version`  | integer |     ✅    | `8623`                                          | Version of the Pushbullet app installed on the device (non-negative) |
| `manufacturer` | string  |     ✅    | `"Apple"`                                       | Manufacturer of the device                                           |

***

### `Pushbullet Create Push`

Integration name: **PUSHBULLET\_CREATE\_PUSH**

Tool to send a new push (note, link, or file) to a device, user, channel, or client. Use when you need to share content to a specific target. Example: "Send a link to <https://example.com> to device abc123".

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example              | Description                                                            |
| -------------------- | ------ | :------: | -------------------- | ---------------------------------------------------------------------- |
| `url`                | string |          | —                    | URL to include with a link push. Required when type='link'.            |
| `body`               | string |          | —                    | Body text of the note, link message, or file message.                  |
| `guid`               | string |          | —                    | Client-generated unique identifier for idempotency.                    |
| `type`               | string |     ✅    | —                    | Type of push to send: 'note', 'link', or 'file'.                       |
| `email`              | string |          | `"user@example.com"` | Email address to send the push to (Pushbullet user or fallback email). |
| `title`              | string |          | —                    | Title of the note or link (optional).                                  |
| `file_url`           | string |          | —                    | URL of the file to push. Required when type='file'.                    |
| `file_name`          | string |          | —                    | Filename for file push. Required when type='file'.                     |
| `file_type`          | string |          | —                    | MIME type of the file. Required when type='file'.                      |
| `channel_tag`        | string |          | —                    | Tag of channel to broadcast the push to subscribers.                   |
| `client_iden`        | string |          | —                    | Identifier of OAuth client to send the push to its authorized users.   |
| `device_iden`        | string |          | —                    | Identifier of device to send the push to.                              |
| `source_device_iden` | string |          | —                    | Identifier of the source device sending this push.                     |

***

### `Pushbullet Delete All Pushes`

Integration name: **PUSHBULLET\_DELETE\_ALL\_PUSHES**

Tool to delete all pushes for the current user asynchronously. Use when you need to bulk-clear all existing pushes in one call.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Pushbullet Delete Chat`

Integration name: **PUSHBULLET\_DELETE\_CHAT**

Tool to delete a chat by its identifier. Use when you need to remove a chat from your Pushbullet account after confirming its identifier.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                  | Description                                  |
| --------- | ------ | :------: | ------------------------ | -------------------------------------------- |
| `iden`    | string |     ✅    | `"ujpah72o0sjAoRtnM0jc"` | The unique identifier of the chat to delete. |

***

### `Pushbullet Delete Device`

Integration name: **PUSHBULLET\_DELETE\_DEVICE**

Tool to remove a device by its identifier. Use when you need to delete a device from your Pushbullet account after confirming its identifier.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                              | Description                                    |
| ------------- | ------ | :------: | ------------------------------------ | ---------------------------------------------- |
| `device_iden` | string |     ✅    | `"ujEDGjVwOZMuXc7fRv5fQZh8YHC0Y8CE"` | The unique identifier of the device to delete. |

***

### `Pushbullet Delete Push`

Integration name: **PUSHBULLET\_DELETE\_PUSH**

Tool to delete a specific push by its identifier. Use when you need to remove a push after confirming its identifier.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                  | Description                      |
| --------- | ------ | :------: | ------------------------ | -------------------------------- |
| `iden`    | string |     ✅    | `"ujpah72o0sjAoRtnM0jc"` | Identifier of the push to delete |

***

### `Pushbullet Get User`

Integration name: **PUSHBULLET\_GET\_USER**

Tool to retrieve the currently authenticated user's profile. Use when you need to verify the access token or display the current user's details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Pushbullet List Chats`

Integration name: **PUSHBULLET\_LIST\_CHATS**

Tool to list all chat objects for the current user. Use when you need the full set of chat threads before sending or muting messages.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example                 | Description                                            |
| --------- | ------- | :------: | ----------------------- | ------------------------------------------------------ |
| `limit`   | integer |          | `100`                   | Maximum number of chats to return (max 500).           |
| `cursor`  | string  |          | `"uj4FvJxxe1HPabcdefg"` | Cursor for pagination to fetch the next page of chats. |

***

### `Pushbullet List Devices`

Integration name: **PUSHBULLET\_LIST\_DEVICES**

Tool to list all registered devices for the current user. Use after obtaining a valid access token.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Pushbullet List Pushes`

Integration name: **PUSHBULLET\_LIST\_PUSHES**

Tool to list pushes with optional filtering and pagination. Use when retrieving or syncing pushes after a certain time.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                 | Description                                                    |
| ---------------- | ------- | :------: | ----------------------- | -------------------------------------------------------------- |
| `limit`          | integer |          | `100`                   | Maximum number of pushes to return (max 500, default 500).     |
| `active`         | boolean |          | `true`                  | If true, only active pushes are returned.                      |
| `cursor`         | string  |          | `"uj4FvJxxe1HPabcdefg"` | Cursor for pagination to fetch the next set of pushes.         |
| `modified_after` | number  |          | `1620000000`            | Only return pushes modified after this UNIX timestamp (float). |

***

### `Pushbullet Update Chat`

Integration name: **PUSHBULLET\_UPDATE\_CHAT**

Tool to mute or unmute an existing chat. Use when adjusting notification settings for a specific chat by its identifier.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example                  | Description                                               |
| --------- | ------- | :------: | ------------------------ | --------------------------------------------------------- |
| `iden`    | string  |     ✅    | `"ujpah72o0sjAoRtnM0jc"` | Unique identifier of the chat to update                   |
| `muted`   | boolean |     ✅    | `true`                   | True to mute notifications for this chat, false to unmute |

***

### `Pushbullet Update Device`

Integration name: **PUSHBULLET\_UPDATE\_DEVICE**

Tool to update metadata for a device by its identifier. Use when changing a device's nickname, model, or other settings.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                                         | Description                                                                             |
| -------------- | ------- | :------: | ----------------------------------------------- | --------------------------------------------------------------------------------------- |
| `icon`         | string  |          | `"ios"`                                         | Icon for the device. Common values: desktop, laptop, tablet, phone, watch, system, ios. |
| `iden`         | string  |     ✅    | `"ujpah72o0sjAoRtnM0jc"`                        | Identifier of the device to update.                                                     |
| `model`        | string  |          | `"iPhone 5s (GSM)"`                             | Model of the device.                                                                    |
| `has_sms`      | boolean |          | `true`                                          | Whether the device supports SMS (Android only).                                         |
| `nickname`     | string  |          | `"Work Phone"`                                  | New display name for the device.                                                        |
| `push_token`   | string  |          | `"production:f73be0ee7877c8c7fa69b1468cde764f"` | Platform-specific push token. Leave blank for custom or listening devices.              |
| `app_version`  | integer |          | `8623`                                          | Version of the Pushbullet app installed on the device (non-negative).                   |
| `manufacturer` | string  |          | `"Apple"`                                       | Manufacturer of the device.                                                             |

***

### `Pushbullet Update Push`

Integration name: **PUSHBULLET\_UPDATE\_PUSH**

Tool to update a push (dismiss or modify list items) by its identifier. Use when marking a push as dismissed or updating list push items.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                              | Description                                                     |
| ----------- | ------- | :------: | ------------------------------------ | --------------------------------------------------------------- |
| `iden`      | string  |     ✅    | `"ujpah72o0sjAoRtnM0jc"`             | Unique identifier of the push to update                         |
| `items`     | array   |          | `{"text":"Item One","checked":true}` | List of items to update for list-style pushes                   |
| `dismissed` | boolean |          | `true`                               | Set to true to mark the push as dismissed (hides notifications) |

***

### `Pushbullet Upload Request`

Integration name: **PUSHBULLET\_UPLOAD\_REQUEST**

Tool to obtain a signed upload URL for a file before pushing. Use when you need to upload file content via the signed S3 form data.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example        | Description                                      |
| ----------- | ------ | :------: | -------------- | ------------------------------------------------ |
| `file_name` | string |     ✅    | `"photo.jpg"`  | Name of the file to upload. Example: 'photo.jpg' |
| `file_type` | string |     ✅    | `"image/jpeg"` | MIME type of the file. Example: 'image/jpeg'     |

***