tickerbot.io
Endpoints

Register a device

POSThttps://api.tickerbot.io/v2/devices/register

Records a phone or tablet push token and returns a stable device_id.

stringrequired

Expo push token in ExponentPushToken[...] form.

stringenumrequired

Device platform.

iosApple devices.
androidAndroid devices.
string

Display name for the device picker. Max 60 characters. Set at first registration only: re-registering the same token keeps the existing name (and platform).

CodeMeaning
201The device record: device_id, device_name, platform, created_at, last_seen. Same shape and same 201 when the token was already registered; only last_seen refreshes.
400Missing/malformed expo_push_token, invalid platform or device_name too long.
  • For the mobile_push webhook delivery channel. The Tickerbot mobile app calls this automatically on sign-in and foreground; you call it directly only when wiring push delivery yourself.
  • Idempotent on the Expo push token: re-registering the same token returns the existing device_id rather than minting a new one, so an OS-side token refresh never breaks webhooks pointed at that device. An app reinstall mints a new token and therefore a new device_id, so re-pick the device on your webhooks.