← tickerbot.io
View as markdown
Endpoints

Register a device

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

Record a phone or tablet push token; returns a stable device_id.

Body parameters

stringrequired

Expo push token in ExponentPushToken[...] form. (expoPushToken accepted as an alias.)

enumrequired

Device platform.

iosApple devices.
androidAndroid devices.
string

Display name for the device picker. Max 60 characters. (deviceName accepted as an alias.) Set at first registration only — re-registering the same token keeps the existing name (and platform), and there is no rename endpoint.

Status codes

201
The 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.
400
Missing/malformed expo_push_token, invalid platform, or device_name too long.

Notes

  • For the mobile_push webhook delivery channel. The Tickerbot mobile app calls this automatically on sign-in and foreground — you only call it directly 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 — re-pick the device on your webhooks.