Pushbullet API

https://docs.pushbullet.com
Admin
The Pushbullet API enables developers to build on Pushbullet's infrastructure, allowing real-time...
Tokens:340,533
Snippets:1,138
Trust Score:9.6
Update:1 year ago
Show doc for...
Tokens:
Raw
### Example API Request (Get Pushes)

Source: https://docs.pushbullet.com/v2/devices

Example of how to make a GET request to the Pushbullet API to retrieve pushes, including authentication and query parameters.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     --data-urlencode "active=true" \
     --data-urlencode "modified_after=1.4e+09" \
     --get \
     https://api.pushbullet.com/v2/pushes
```

--------------------------------

### Example API Request (Get Pushes)

Source: https://docs.pushbullet.com/v2/pushes

Example of how to make a GET request to the Pushbullet API to retrieve pushes, including authentication and query parameters.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     --data-urlencode "active=true" \
     --data-urlencode "modified_after=1.4e+09" \
     --get \
     https://api.pushbullet.com/v2/pushes
```

--------------------------------

### Example API Request (Get Pushes)

Source: https://docs.pushbullet.com/v2/upload-request

Example of how to make a GET request to the Pushbullet API to retrieve pushes, including authentication and query parameters.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     --data-urlencode "active=true" \
     --data-urlencode "modified_after=1.4e+09" \
     --get \
     https://api.pushbullet.com/v2/pushes
```

--------------------------------

### Example API Request (Get Pushes)

Source: https://docs.pushbullet.com/index

Example of how to make a GET request to the Pushbullet API to retrieve pushes, including authentication and query parameters.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     --data-urlencode "active=true" \
     --data-urlencode "modified_after=1.4e+09" \
     --get \
     https://api.pushbullet.com/v2/pushes
```

--------------------------------

### Example API Request (Get Pushes)

Source: https://docs.pushbullet.com/v17

Example of how to make a GET request to the Pushbullet API to retrieve pushes, including authentication and query parameters.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     --data-urlencode "active=true" \
     --data-urlencode "modified_after=1.4e+09" \
     --get \
     https://api.pushbullet.com/v2/pushes
```

--------------------------------

### Example API Request (Get Pushes)

Source: https://docs.pushbullet.com/v18

Example of how to make a GET request to the Pushbullet API to retrieve pushes, including authentication and query parameters.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     --data-urlencode "active=true" \
     --data-urlencode "modified_after=1.4e+09" \
     --get \
     https://api.pushbullet.com/v2/pushes
```

--------------------------------

### Example API Request (Get Pushes)

Source: https://docs.pushbullet.com/v16

Example of how to make a GET request to the Pushbullet API to retrieve pushes, including authentication and query parameters.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     --data-urlencode "active=true" \
     --data-urlencode "modified_after=1.4e+09" \
     --get \
     https://api.pushbullet.com/v2/pushes
```

--------------------------------

### Pushbullet API: Create Subscription Example

Source: https://docs.pushbullet.com/v15

Example request and response for creating a Pushbullet subscription to a specific channel tag.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --header 'Content-Type: application/json' \
     --data-binary '{"channel_tag":"elonmusknews"}' \
     --request POST \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "active": true,
  "channel": {
    "description": "News about Elon Musk.",
    "iden": "ujxPklLhvyKsjAvkMyTVh6",
    "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
    "name": "Elon Musk News",
    "tag": "elonmusknews"
  },
  "created": 1.412047948579029e+09,
  "iden": "ujpah72o0sjAoRtnM0jc",
  "modified": 1.412047948579031e+09
}
```

--------------------------------

### Pushbullet API: List Subscriptions Example

Source: https://docs.pushbullet.com/v15

Example request and response for listing Pushbullet subscriptions.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "subscriptions": [
    {
      "active": true,
      "channel": {
        "description": "News about Elon Musk.",
        "iden": "ujxPklLhvyKsjAvkMyTVh6",
        "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
        "name": "Elon Musk News",
        "tag": "elonmusknews"
      },
      "created": 1.412047948579029e+09,
      "iden": "ujpah72o0sjAoRtnM0jc",
      "modified": 1.412047948579031e+09
    }
  ]
}
```

--------------------------------

### Pushbullet API: Create Subscription Example

Source: https://docs.pushbullet.com/v14

Example request and response for creating a Pushbullet subscription to a specific channel tag.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --header 'Content-Type: application/json' \
     --data-binary '{"channel_tag":"elonmusknews"}' \
     --request POST \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "active": true,
  "channel": {
    "description": "News about Elon Musk.",
    "iden": "ujxPklLhvyKsjAvkMyTVh6",
    "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
    "name": "Elon Musk News",
    "tag": "elonmusknews"
  },
  "created": 1.412047948579029e+09,
  "iden": "ujpah72o0sjAoRtnM0jc",
  "modified": 1.412047948579031e+09
}
```

--------------------------------

### Pushbullet API: List Subscriptions Example

Source: https://docs.pushbullet.com/v13

Example request and response for listing Pushbullet subscriptions.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "subscriptions": [
    {
      "active": true,
      "channel": {
        "description": "News about Elon Musk.",
        "iden": "ujxPklLhvyKsjAvkMyTVh6",
        "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
        "name": "Elon Musk News",
        "tag": "elonmusknews"
      },
      "created": 1.412047948579029e+09,
      "iden": "ujpah72o0sjAoRtnM0jc",
      "modified": 1.412047948579031e+09
    }
  ]
}
```

--------------------------------

### Pushbullet API: List Subscriptions Example

Source: https://docs.pushbullet.com/v14

Example request and response for listing Pushbullet subscriptions.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "subscriptions": [
    {
      "active": true,
      "channel": {
        "description": "News about Elon Musk.",
        "iden": "ujxPklLhvyKsjAvkMyTVh6",
        "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
        "name": "Elon Musk News",
        "tag": "elonmusknews"
      },
      "created": 1.412047948579029e+09,
      "iden": "ujpah72o0sjAoRtnM0jc",
      "modified": 1.412047948579031e+09
    }
  ]
}
```

--------------------------------

### Pushbullet API: Create Subscription Example

Source: https://docs.pushbullet.com/v12

Example request and response for creating a Pushbullet subscription to a specific channel tag.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --header 'Content-Type: application/json' \
     --data-binary '{"channel_tag":"elonmusknews"}' \
     --request POST \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "active": true,
  "channel": {
    "description": "News about Elon Musk.",
    "iden": "ujxPklLhvyKsjAvkMyTVh6",
    "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
    "name": "Elon Musk News",
    "tag": "elonmusknews"
  },
  "created": 1.412047948579029e+09,
  "iden": "ujpah72o0sjAoRtnM0jc",
  "modified": 1.412047948579031e+09
}
```

--------------------------------

### Pushbullet API: Create Subscription Example

Source: https://docs.pushbullet.com/v13

Example request and response for creating a Pushbullet subscription to a specific channel tag.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --header 'Content-Type: application/json' \
     --data-binary '{"channel_tag":"elonmusknews"}' \
     --request POST \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "active": true,
  "channel": {
    "description": "News about Elon Musk.",
    "iden": "ujxPklLhvyKsjAvkMyTVh6",
    "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
    "name": "Elon Musk News",
    "tag": "elonmusknews"
  },
  "created": 1.412047948579029e+09,
  "iden": "ujpah72o0sjAoRtnM0jc",
  "modified": 1.412047948579031e+09
}
```

--------------------------------

### Pushbullet API: List Subscriptions Example

Source: https://docs.pushbullet.com/v12

Example request and response for listing Pushbullet subscriptions.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/subscriptions
```

```json
{
  "subscriptions": [
    {
      "active": true,
      "channel": {
        "description": "News about Elon Musk.",
        "iden": "ujxPklLhvyKsjAvkMyTVh6",
        "image_url": "https://dl.pushbulletusercontent.com/StzRmwdkIe8gluBH3XoJ9HjRqjlUYSf4/musk.jpg",
        "name": "Elon Musk News",
        "tag": "elonmusknews"
      },
      "created": 1.412047948579029e+09,
      "iden": "ujpah72o0sjAoRtnM0jc",
      "modified": 1.412047948579031e+09
    }
  ]
}
```

--------------------------------

### Pushbullet API Overview

Source: https://docs.pushbullet.com/v16

Provides general information about the Pushbullet API, including quick start guides, request and response formats, and object definitions. It also covers authentication mechanisms like OAuth2 and advanced features such as end-to-end encryption and real-time event streams.

```APIDOC
Pushbullet API:
  - API Quick Start
  - API Overview
  - Requests
  - Responses
  - Objects
  - Guides
  - OAuth2
  - End-to-End Encryption
  - Realtime Event Stream
  - Ephemerals
```

--------------------------------

### Get User Information Example (curl)

Source: https://docs.pushbullet.com/v9

Demonstrates how to fetch information about the currently authenticated user using the Pushbullet API via a curl command. It shows the necessary authorization header and the expected JSON response structure.

```curl
curl --header "Authorization: Bearer <your_access_token_here>" https://api.pushbullet.com/v2/users/me
```

--------------------------------

### Pushbullet OAuth Client Example

Source: https://docs.pushbullet.com/v1

Example structure of an OAuth client registered with Pushbullet, containing essential identifiers and URLs for authentication.

```json
{
  "iden": "P8NJ4exxMI8",
  "name": "CatPusher",
  "image_url": "http://www.catpusher.com/logo.png",
  "website_url": "http://www.catpusher.com",
  "redirect_uri": "http://www.catpusher.com/auth_complete",
  "client_id": "YW7uItOzxPFx8vJ4",
  "client_secret": "MmA98EDg0pjr4fZw"
}
```

--------------------------------

### Pushbullet OAuth Client Example

Source: https://docs.pushbullet.com/v4

Example structure of an OAuth client registered with Pushbullet, containing essential identifiers and URLs for authentication.

```json
{
  "iden": "P8NJ4exxMI8",
  "name": "CatPusher",
  "image_url": "http://www.catpusher.com/logo.png",
  "website_url": "http://www.catpusher.com",
  "redirect_uri": "http://www.catpusher.com/auth_complete",
  "client_id": "YW7uItOzxPFx8vJ4",
  "client_secret": "MmA98EDg0pjr4fZw"
}
```

--------------------------------

### Pushbullet OAuth 2.0 Redirect Example (Server-Side)

Source: https://docs.pushbullet.com/v15

Example of a redirect URI for a server-side application after successful authorization, containing the authorization code as a query parameter.

```URL
http://www.catpusher.com/auth_complete?code=RUe7IZgC6384GrI1
```

--------------------------------

### Pushbullet API Overview and Example

Source: https://docs.pushbullet.com/v2/devices

Provides an overview of the Pushbullet API, including authentication methods using an access token and general request formatting. It features a practical example using curl to retrieve the current user's information, demonstrating request headers and response structure.

```APIDOC
Pushbullet API

Overview:
The Pushbullet API allows developers to send and receive pushes, and perform other actions available in official Pushbullet clients. All API requests are made over HTTPS to https://api.pushbullet.com.

Requests:
- POST requests must use a JSON body with the Content-Type header set to application/json.
- Most programming languages provide libraries to encode objects to JSON, which correctly handle newline characters and quotes.

Authentication:
- Access the API using your access token in the 'Access-Token' header: Access-Token: <your_access_token_here>.
- Your access token can be found on your Account Settings page.
- For applications acting on behalf of other users, OAuth should be used to obtain an access token.
- Using your own access token during development is recommended.

Example: Get Current User

Request:
```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/users/me
```

Response:
```json
{
  "created": 1381092887.398433,
  "email": "[email protected]",
  "email_normalized": "[email protected]",
  "iden": "ujpah72o0",
  "image_url": "https://static.pushbullet.com/missing-image/55a7dc-45",
  "max_upload_size": 26214400,
  "modified": 1441054560.741007,
  "name": "Elon Musk"
}
```

Related Information:
- OAuth: For using the API on behalf of other users.
- Stack Overflow: For questions and feedback, use the #pushbullet tag.
```

--------------------------------

### Pushbullet API Overview and Example

Source: https://docs.pushbullet.com/v2/pushes

Provides an overview of the Pushbullet API, including authentication methods using an access token and general request formatting. It features a practical example using curl to retrieve the current user's information, demonstrating request headers and response structure.

```APIDOC
Pushbullet API

Overview:
The Pushbullet API allows developers to send and receive pushes, and perform other actions available in official Pushbullet clients. All API requests are made over HTTPS to https://api.pushbullet.com.

Requests:
- POST requests must use a JSON body with the Content-Type header set to application/json.
- Most programming languages provide libraries to encode objects to JSON, which correctly handle newline characters and quotes.

Authentication:
- Access the API using your access token in the 'Access-Token' header: Access-Token: <your_access_token_here>.
- Your access token can be found on your Account Settings page.
- For applications acting on behalf of other users, OAuth should be used to obtain an access token.
- Using your own access token during development is recommended.

Example: Get Current User

Request:
```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/users/me
```

Response:
```json
{
  "created": 1381092887.398433,
  "email": "[email protected]",
  "email_normalized": "[email protected]",
  "iden": "ujpah72o0",
  "image_url": "https://static.pushbullet.com/missing-image/55a7dc-45",
  "max_upload_size": 26214400,
  "modified": 1441054560.741007,
  "name": "Elon Musk"
}
```

Related Information:
- OAuth: For using the API on behalf of other users.
- Stack Overflow: For questions and feedback, use the #pushbullet tag.
```

--------------------------------

### Create Pushbullet Device (API Example)

Source: https://docs.pushbullet.com/v12

Example of how to register a new device with the Pushbullet API using a curl request. This involves sending device details like model, manufacturer, and push token to the /v2/devices endpoint.

```shell
curl --header 'Access-Token: <your_access_token_here>' \
     --header 'Content-Type: application/json' \
     --data-binary '{"app_version":8623,"manufacturer":"Apple","model":"iPhone 5s (GSM)","nickname":"Elon Musk's iPhone","push_token":"production:f73be0ee7877c8c7fa69b1468cde764f"}' \
     --request POST \
     https://api.pushbullet.com/v2/devices
```

--------------------------------

### Pushbullet OAuth2 Client Registration Example

Source: https://docs.pushbullet.com/v15

Provides an example structure for a Pushbullet OAuth2 client registration, including essential identifiers and URLs required for authentication flows.

```APIDOC
EXAMPLE CLIENT:
{
  "client_id": "YW7uItOzxPFx8vJ4",
  "client_secret": "MmA98EDg0pjr4fZw",
  "iden": "ujpah72o0sjAoRtnM0jc",
  "image_url": "http://www.catpusher.com/logo.png",
  "name": "Cat Pusher",
  "redirect_uri": "http://www.catpusher.com/auth_complete",
  "website_url": "http://www.catpusher.com"
}
```

--------------------------------

### Pushbullet API: Get Current User Response

Source: https://docs.pushbullet.com/v15

Example JSON response for the 'Get Current User' API call, detailing user information.

```json
{
  "created": 1.381092887398433e+09,
  "email": "[email protected]",
  "email_normalized": "[email protected]",
  "iden": "ujpah72o0",
  "image_url": "https://static.pushbullet.com/missing-image/55a7dc-45",
  "max_upload_size": 2.62144e+07,
  "modified": 1.441054560741007e+09,
  "name": "Elon Musk"
}
```

--------------------------------

### Pushbullet API: Get Current User Response

Source: https://docs.pushbullet.com/v14

Example JSON response for the 'Get Current User' API call, detailing user information.

```json
{
  "created": 1.381092887398433e+09,
  "email": "[email protected]",
  "email_normalized": "[email protected]",
  "iden": "ujpah72o0",
  "image_url": "https://static.pushbullet.com/missing-image/55a7dc-45",
  "max_upload_size": 2.62144e+07,
  "modified": 1.441054560741007e+09,
  "name": "Elon Musk"
}
```

--------------------------------

### Pushbullet OAuth2 Client Registration Example

Source: https://docs.pushbullet.com/v14

Provides an example structure for a Pushbullet OAuth2 client registration, including essential identifiers and URLs required for authentication flows.

```APIDOC
EXAMPLE CLIENT:
{
  "client_id": "YW7uItOzxPFx8vJ4",
  "client_secret": "MmA98EDg0pjr4fZw",
  "iden": "ujpah72o0sjAoRtnM0jc",
  "image_url": "http://www.catpusher.com/logo.png",
  "name": "Cat Pusher",
  "redirect_uri": "http://www.catpusher.com/auth_complete",
  "website_url": "http://www.catpusher.com"
}
```

--------------------------------

### Pushbullet API - Get Current User Example

Source: https://docs.pushbullet.com/v16

Demonstrates how to authenticate with the Pushbullet API using an access token and retrieve information about the current user. This example uses the curl command-line tool.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     https://api.pushbullet.com/v2/users/me
```

```APIDOC
Request:
  GET https://api.pushbullet.com/v2/users/me
  Headers:
    Access-Token: <your_access_token_here>

Response:
  Status: 200 OK
  Body:
    {
      "created": 1381092887.398433,
      "email": "[email protected]",
      "email_normalized": "[email protected]",
      "iden": "ujpah72o0",
      "image_url": "https://static.pushbullet.com/missing-image/55a7dc-45",
      "max_upload_size": 26214400,
      "modified": 1441054560.741007,
      "name": "Elon Musk"
    }

Description:
  Retrieves details of the authenticated user, including their identifier, email, name, and account settings. Requires a valid Access-Token in the request header for authentication.
```

--------------------------------

### Pushbullet API: Get Current User (curl)

Source: https://docs.pushbullet.com/v2/upload-request

Example using curl to retrieve information about the currently authenticated user by making a GET request to the /v2/users/me endpoint. Requires an access token for authentication.

```curl
curl --header "Access-Token: <your_access_token_here>" \
     https://api.pushbullet.com/v2/users/me
```

--------------------------------

### Get Current User Info with XMLHttpRequest

Source: https://docs.pushbullet.com/v5

An example showing how to use the XMLHttpRequest object in JavaScript to make a GET request to the Pushbullet API to fetch user details. It demonstrates how to set the Authorization header for API access from a browser.

```javascript
var xhr = new XMLHttpRequest();
xhr.open("GET", "https://api.pushbullet.com/v2/users/me", true);
xhr.setRequestHeader("Authorization", "Bearer <your_access_token_here>");
xhr.send();

xhr.onload = function() {
  if (xhr.status === 200) {
    console.log(JSON.parse(xhr.responseText));
  } else {
    console.error("Request failed. Status: " + xhr.status);
  }
};
```

--------------------------------

### Pushbullet API: Get Current User

Source: https://docs.pushbullet.com/v15

Example cURL request to retrieve the details of the currently authenticated user using an access token.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/users/me
```

--------------------------------

### Pushbullet API: Get Current User

Source: https://docs.pushbullet.com/v14

Example cURL request to retrieve the details of the currently authenticated user using an access token.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/users/me
```

--------------------------------

### Get Current User Info with Curl

Source: https://docs.pushbullet.com/v5

An example demonstrating how to use the curl command-line tool to authenticate with the Pushbullet API and retrieve information about the currently authenticated user.

```bash
curl -u <your_access_token_here>: https://api.pushbullet.com/v2/users/me
```

--------------------------------

### Fetch User Information with XMLHttpRequest

Source: https://docs.pushbullet.com/v8

Example of using XMLHttpRequest to make a GET request to the Pushbullet API to retrieve user information. It includes setting the authorization header and sending the request.

```javascript
var xhr = new XMLHttpRequest()
xhr.open("GET", "https://api.pushbullet.com/v2/users/me", false)
xhr.setRequestHeader("Authorization", "Bearer <your_access_token_here>")
xhr.send()
console.log(xhr)
```

--------------------------------

### Get Current User with Curl

Source: https://docs.pushbullet.com/v13

Demonstrates how to retrieve the current user's information using a curl command with an access token. This example shows the request format and the expected JSON response structure.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/users/me
```

```json
{
  "created": 1.381092887398433e+09,
  "email": "[email\u00a0protected]",
  "email_normalized": "[email\u00a0protected]",
  "iden": "ujpah72o0",
  "image_url": "https://static.pushbullet.com/missing-image/55a7dc-45",
  "max_upload_size": 2.62144e+07,
  "modified": 1.441054560741007e+09,
  "name": "Elon Musk"
}
```

--------------------------------

### Get Current User with Curl

Source: https://docs.pushbullet.com/v12

Demonstrates how to retrieve the current user's information using a curl command with an access token. This example shows the request format and the expected JSON response structure.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     https://api.pushbullet.com/v2/users/me
```

```json
{
  "created": 1.381092887398433e+09,
  "email": "[email\u00a0protected]",
  "email_normalized": "[email\u00a0protected]",
  "iden": "ujpah72o0",
  "image_url": "https://static.pushbullet.com/missing-image/55a7dc-45",
  "max_upload_size": 2.62144e+07,
  "modified": 1.441054560741007e+09,
  "name": "Elon Musk"
}
```

--------------------------------

### Get Current User with JavaScript

Source: https://docs.pushbullet.com/v11

Shows how to retrieve the current user's details from the Pushbullet API using JavaScript's XMLHttpRequest object. This example is runnable directly in a browser's JavaScript console and includes setting the 'Access-Token' header.

```javascript
var xhr = new XMLHttpRequest()
xhr.open("GET", "https://api.pushbullet.com/v2/users/me", false)
xhr.setRequestHeader("Access-Token", "<your_access_token_here>")
xhr.send()
console.log(xhr.responseText)
```

--------------------------------

### Pushbullet Push Message Examples

Source: https://docs.pushbullet.com/v1

Illustrates the structure of 'push' messages, detailing the 'mirror' and 'dismissal' types within the 'push' object, including fields like iden, package_name, title, and body.

```json
{
  "type": "push",
  "push": {
    "type": "mirror",
    "iden": "pjgzwwn3YPQ",
    "source_device_iden": "ubddjAzSDVLgrI",
    "package_name": "com.pushbullet.android",
    "application_name": "Pushbullet",
    "notification_id": "-8",
    "notification_tag": null,
    "dismissable": true,
    "title": "Mirroring test",
    "body": "If you see this on your computer, mirroring is working!\n",
    "icon": "iVBORw0KGgoAAAANSUhEBgUzC42AAAADNElEQVRo\ng==\n",
    "created": 1399350964.1649699,
    "sender_iden": "ubd",
    "sender_email": "[email\u00a0protected]",
    "sender_email_normalized": "[email\u00a0protected]",
    "receiver_iden": "ubd",
    "receiver_email": "[email\u00a0protected]",
    "receiver_email_normalized": "[email\u00a0protected]"
  }
}

{
  "type": "push",
  "push":{
    "type": "dismissal",
    "iden": "pjgzwwocCCy",
    "source_device_iden": "ubddjAzSDVLgrI",
    "package_name": "com.pushbullet.android",
    "notification_id": "-8",
    "notification_tag":null,
    "created":1399350966.22458,
    "sender_iden": "ubd",
    "sender_email": "[email\u00a0protected]",
    "sender_email_normalized": "[email\u00a0protected]",
    "receiver_iden": "ubd",
    "receiver_email": "[email\u00a0protected]",
    "receiver_email_normalized": "[email\u00a0protected]"
  }
}
```

--------------------------------

### Example Response: User Me

Source: https://docs.pushbullet.com/v3

A sample JSON response from the /v2/users/me endpoint, showing basic user profile information.

```json
{
  "iden": "uLalKS9SKk",
  "email": "[email\u00a0protected]",
  ...
}
```

--------------------------------

### Pushbullet API: Example Error Response

Source: https://docs.pushbullet.com/v9

An example of the JSON structure for error responses received from the Pushbullet server.

```json
{
  "error": {
      "message": "The resource could not be found.",
      "type": "invalid_request",
      "cat": "~(=^‥^)"
  }
}
```

--------------------------------

### Pushbullet Push Message Examples

Source: https://docs.pushbullet.com/v4

Illustrates the structure of 'push' messages, detailing the 'mirror' and 'dismissal' types within the 'push' object, including fields like iden, package_name, title, and body.

```json
{
  "type": "push",
  "push": {
    "type": "mirror",
    "iden": "pjgzwwn3YPQ",
    "source_device_iden": "ubddjAzSDVLgrI",
    "package_name": "com.pushbullet.android",
    "application_name": "Pushbullet",
    "notification_id": "-8",
    "notification_tag": null,
    "dismissable": true,
    "title": "Mirroring test",
    "body": "If you see this on your computer, mirroring is working!\n",
    "icon": "iVBORw0KGgoAAAANSUhEBgUzC42AAAADNElEQVRo\ng==\n",
    "created": 1399350964.1649699,
    "sender_iden": "ubd",
    "sender_email": "[email\u00a0protected]",
    "sender_email_normalized": "[email\u00a0protected]",
    "receiver_iden": "ubd",
    "receiver_email": "[email\u00a0protected]",
    "receiver_email_normalized": "[email\u00a0protected]"
  }
}

{
  "type": "push",
  "push":{
    "type": "dismissal",
    "iden": "pjgzwwocCCy",
    "source_device_iden": "ubddjAzSDVLgrI",
    "package_name": "com.pushbullet.android",
    "notification_id": "-8",
    "notification_tag":null,
    "created":1399350966.22458,
    "sender_iden": "ubd",
    "sender_email": "[email\u00a0protected]",
    "sender_email_normalized": "[email\u00a0protected]",
    "receiver_iden": "ubd",
    "receiver_email": "[email\u00a0protected]",
    "receiver_email_normalized": "[email\u00a0protected]"
  }
}
```

--------------------------------

### Example API Response for /v2/users/me

Source: https://docs.pushbullet.com/v7

Illustrates a typical JSON response when querying the `/v2/users/me` endpoint, showing user identification, email, and account creation/modification timestamps.

```APIDOC
##### EXAMPLE RESPONSE

```json
{
  "iden": "ubdpjxakjjk1G",
  "email": "[email protected]",
  "email_normalized": "[email protected]",
  "created": 1357941753.8287899,
  "modified": 1399325992.1842301,
  ...
}
```
```

--------------------------------

### Pushbullet User Data Example

Source: https://docs.pushbullet.com/v3

An example JSON response structure representing user data, including identifiers, timestamps, and preferences.

```json
{
  "iden": "ubdpjxxxOK0sKG",
  "email": "[email\u00a0protected]",
  "email_normalized": "[email\u00a0protected]",
  "created": 1357941753.8287899,
  "modified": 1399325992.1842301,
  "name": "Ryan Oldenburg",
  "image_url": "https://lh4.googleusercontent.com/-YGdcF2MteeI/AAAAAAAAAAI/AAAAAAAADPU/uo9z33FoEYs/photo.jpg",
  "preferences": {
    "cat": "^. .^"
  }
}
```

--------------------------------

### Create Device API Request Example

Source: https://docs.pushbullet.com/v16

Demonstrates how to register a new device with the Pushbullet API using a curl command. It includes necessary headers like Access-Token and Content-Type, along with the JSON payload containing device details.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --header 'Content-Type: application/json' \
     --data-binary '{"app_version":8623,"manufacturer":"Apple","model":"iPhone 5s (GSM)","nickname":"Elon Musk's iPhone","push_token":"production:f73be0ee7877c8c7fa69b1468cde764f"}' \
     --request POST \
     https://api.pushbullet.com/v2/devices
```

--------------------------------

### Delete Pushes Example

Source: https://docs.pushbullet.com/v2/upload-request

Example of how to delete all pushes using the Pushbullet API. This operation requires an access token for authentication.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --request DELETE \
     https://api.pushbullet.com/v2/pushes
```

```json
{}
```

--------------------------------

### Delete Pushes Example

Source: https://docs.pushbullet.com/v2/pushes

Example of how to delete all pushes using the Pushbullet API. This operation requires an access token for authentication.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --request DELETE \
     https://api.pushbullet.com/v2/pushes
```

```json
{}
```

--------------------------------

### Pushbullet OAuth Client Registration Example

Source: https://docs.pushbullet.com/v11

Example JSON object representing a registered OAuth client application with Pushbullet. This includes identifiers, URLs, and secrets necessary for authentication flows.

```json
{
  "iden": "P8NJ4exxMI8",
  "name": "CatPusher",
  "image_url": "http://www.catpusher.com/logo.png",
  "website_url": "http://www.catpusher.com",
  "redirect_uri": "http://www.catpusher.com/auth_complete",
  "client_id": "YW7uItOzxPFx8vJ4",
  "client_secret": "MmA98EDg0pjr4fZw"
}
```

--------------------------------

### Delete Pushes Example

Source: https://docs.pushbullet.com/v2/devices

Example of how to delete all pushes using the Pushbullet API. This operation requires an access token for authentication.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --request DELETE \
     https://api.pushbullet.com/v2/pushes
```

```json
{}
```

--------------------------------

### Pushbullet OAuth 2.0 Redirect Example (Server-Side)

Source: https://docs.pushbullet.com/v14

Example of a redirect URI for a server-side application after successful authorization, containing the authorization code as a query parameter.

```URL
http://www.catpusher.com/auth_complete?code=RUe7IZgC6384GrI1
```

--------------------------------

### Delete Pushes Example

Source: https://docs.pushbullet.com/v18

Example of how to delete all pushes using the Pushbullet API. This operation requires an access token for authentication.

```curl
curl --header 'Access-Token: <your_access_token_here>' \
     --request DELETE \
     https://api.pushbullet.com/v2/pushes
```

```json
{}
```

--------------------------------

### Pushbullet OAuth Client Registration Example

Source: https://docs.pushbullet.com/v10

Example JSON object representing a registered OAuth client application with Pushbullet. This includes identifiers, URLs, and secrets necessary for authentication flows.

```json
{
  "iden": "P8NJ4exxMI8",
  "name": "CatPusher",
  "image_url": "http://www.catpusher.com/logo.png",
  "website_url": "http://www.catpusher.com",
  "redirect_uri": "http://www.catpusher.com/auth_complete",
  "client_id": "YW7uItOzxPFx8vJ4",
  "client_secret": "MmA98EDg0pjr4fZw"
}
```
Tokens:
Raw