# Pushbullet

Pushbullet enables seamless sharing of notifications and files across devices.

- **Category:** notifications
- **Auth:** OAUTH2, API_KEY
- **Composio Managed App Available?** Yes
- **Tools:** 15
- **Triggers:** 0
- **Slug:** `PUSHBULLET`
- **Version:** 20260227_00

## Tools

### Create Chat

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email of the person to create the chat with (does not have to be a Pushbullet user). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Register Device

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon` | string ("desktop" | "browser" | "website" | "laptop" | "tablet" | "phone" | "watch" | "system" | "ios") | No | Icon for this device; e.g., desktop, phone, watch, etc. |
| `model` | string | Yes | Model of the device |
| `has_sms` | boolean | No | True if the device has SMS capability (Android only) |
| `nickname` | string | Yes | Name to display for the device |
| `push_token` | string | No | Platform-specific push token; leave blank for custom devices |
| `app_version` | integer | Yes | Version of the Pushbullet app installed on the device (non-negative) |
| `manufacturer` | string | Yes | Manufacturer of the device |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Push

**Slug:** `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".

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete All Pushes

**Slug:** `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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Chat

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `iden` | string | Yes | The unique identifier of the chat to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Pushbullet Device

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `device_iden` | string | Yes | The unique identifier of the device to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Push

**Slug:** `PUSHBULLET_DELETE_PUSH`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `iden` | string | Yes | Identifier of the push to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get current user

**Slug:** `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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Chats

**Slug:** `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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Devices

**Slug:** `PUSHBULLET_LIST_DEVICES`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pushes

**Slug:** `PUSHBULLET_LIST_PUSHES`

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

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Mute or Unmute Chat

**Slug:** `PUSHBULLET_UPDATE_CHAT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `iden` | string | Yes | Unique identifier of the chat to update |
| `muted` | boolean | Yes | True to mute notifications for this chat, false to unmute |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Device

**Slug:** `PUSHBULLET_UPDATE_DEVICE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon` | string ("desktop" | "browser" | "website" | "laptop" | "tablet" | "phone" | "watch" | "system" | "ios") | No | Icon for the device. Common values: desktop, laptop, tablet, phone, watch, system, ios. |
| `iden` | string | Yes | Identifier of the device to update. |
| `model` | string | No | Model of the device. |
| `has_sms` | boolean | No | Whether the device supports SMS (Android only). |
| `nickname` | string | No | New display name for the device. |
| `push_token` | string | No | Platform-specific push token. Leave blank for custom or listening devices. |
| `app_version` | integer | No | Version of the Pushbullet app installed on the device (non-negative). |
| `manufacturer` | string | No | Manufacturer of the device. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Push

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `iden` | string | Yes | Unique identifier of the push to update |
| `items` | array | No | List of items to update for list-style pushes |
| `dismissed` | boolean | No | Set to true to mark the push as dismissed (hides notifications) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Request

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |