Endpoints
Register a device
POST
https://api.tickerbot.io/ v2/ devices/ registerRecords a phone or tablet push token and returns a stable device_id.
Body parameters
stringrequiredExpo push token in ExponentPushToken[...] form.
stringenumrequiredDevice platform.
ios | Apple devices. |
android | Android devices. |
stringDisplay name for the device picker. Max 60 characters. Set at first registration only: re-registering the same token keeps the existing name (and platform).
Status codes
| Code | Meaning |
|---|---|
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_pushwebhook 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_idrather 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 newdevice_id, so re-pick the device on your webhooks.