Skip to main content
POST
Register a listener push device

Authorizations

Authorization
string
header
required

Station-scoped listener credential. Send Authorization: Bearer <token>, for example Bearer rtm_…. Sending the rtm_ token alone without Bearer returns 401 UNAUTHENTICATED. In the interactive playground, enter only the raw rtm_ token; the playground adds the prefix. Listener REST and GraphQL: listener:read. Listener devices: push:register.

Path Parameters

stationSlug
string
required

Public station slug from the station settings; distinct from the internal station ID.

Required string length: 3 - 63

Body

application/json
token
string
required

Push provider device token. This is not an API credential; never use a real device token in shared examples.

Required string length: 1 - 4096
Example:

"fictional-fcm-device-token"

platform
enum<string>
required

Device operating system.

Available options:
ios,
android
Example:

"android"

provider
enum<string>
required

Configured push provider or embed provider; use the allowed values.

Available options:
fcm,
apns,
expo
Example:

"fcm"

Response

Registered or refreshed the existing device token This imported contract does not specify a response body; treat the HTTP status as the documented result.