Channels

Channels group related notifications and define their audience. Devices subscribe to channels individually.

Create channels from the dashboard or idempotently ensure one through the API:

curl -X PUT https://api.pushtower.com/api/channels/ensure/server-alerts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Server Alerts",
    "sendAccess": "restricted",
    "joinAccess": "personal"
  }'

Repeating the same request returns the existing channel.

Access

• sendAccess: restricted requires an authorized API key. Use this by default.
• sendAccess: open allows unauthenticated sends through the channel ingress.
• joinAccess: personal limits the channel to its owner.
• joinAccess: invite permits invited subscribers.
• joinAccess: public permits public subscription.

Aliases contain 3–64 lowercase letters, numbers, hyphens, or underscores.