Password Pusher API v2

BETA

Comprehensive REST API documentation for integrating Password Pusher into your applications

Beta Notice: API v2 is currently in beta. While we've made every effort to ensure stability, there may be breaking changes before the final release. We welcome your feedback!

Accounts

Accounts enable multi-tenant functionality, allowing users to organize pushes and requests into separate workspaces. Users can belong to multiple accounts and use the account_id parameter when creating pushes or requests to associate them with a specific account.

By default, you have one account. On pwpush.com, you can create additional accounts for your team or organization. In Self-Hosted Pro, only one account is created for you.

Use this API endpoint if you wish to retrieve a value for the account_id parameter when creating pushes or requests on pwpush.com.

GET /api/v2/accounts

Returns a list of all accounts that the authenticated user is a member of. This is useful for determining which account_id to use when creating pushes or requests.

Example Request

curl -X GET https://us.pwpush.com/api/v2/accounts \
  -H "Authorization: Bearer YOUR_API_TOKEN"

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://us.pwpush.com/api/v2/accounts')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri.path)
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts JSON.pretty_generate(JSON.parse(response.body))

import requests
import json

url = 'https://us.pwpush.com/api/v2/accounts'
headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.get(url, headers=headers)
print(json.dumps(response.json(), indent=2))

$headers = @{
    'Authorization' = 'Bearer YOUR_API_TOKEN'
}

$response = Invoke-RestMethod -Uri 'https://us.pwpush.com/api/v2/accounts' `
    -Method Get `
    -Headers $headers

$response | ConvertTo-Json -Depth 10

Example Response

[
  {
    "id": 1,
    "name": "My Personal Account",
    "created_at": "2023-10-27T10:00:00.000Z",
    "updated_at": "2023-10-27T10:00:00.000Z"
  },
  {
    "id": 2,
    "name": "Acme Corporation",
    "created_at": "2023-10-20T08:00:00.000Z",
    "updated_at": "2023-10-20T08:00:00.000Z"
  }
]

Response Fields

Field	Type	Description
`id`	integer	Unique identifier for the account. Use this value for the `account_id` parameter when creating pushes or requests.
`name`	string	The display name of the account
`created_at`	string (ISO 8601)	Timestamp when the account was created
`updated_at`	string (ISO 8601)	Timestamp when the account was last updated

Using Account IDs

When creating pushes or requests, you can optionally specify an account_id parameter to associate the resource with a specific account. If omitted, the resource will be associated with your default account.