Skip to main content

Channels

A channel is the routing primitive in Pushmark. Every notification is sent to a channel, and each channel fans the notification out to the devices subscribed to it. A channel is identified by its hash — a short, opaque ID.

Create a channel​

Create a channel in the dashboard or in the Pushmark iOS app. Creating one in the app also subscribes the device you created it from, so your iPhone starts receiving that channel immediately — the common case for personal notifications.

Subscribe a device​

A device receives a channel's notifications once it is subscribed. From the iOS app, subscribe the current device by any of:

  • scanning the channel's QR code,
  • opening its join link — https://pushmark.app/join/<hash> (or pushmark://join/<hash>),
  • entering the channel code (the hash) manually.

To receive a channel on another device, run the same step on that device. The QR code and join link are shareable, so the same flow lets other people subscribe their devices.

Channel hash​

The hash is the send target:

POST https://api.pushmark.app/<channel_hash>

A request to that URL is delivered to every device currently subscribed to the channel. Treat the hash as a write credential for the channel: anyone who has it can post to it. Rotate to a new channel if a hash is exposed or you need to reset distribution.