# 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'     |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/pushbullet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
