View as markdown
Endpoints · Devices

Register a device

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

Registers a device for the mobile_push webhook delivery channel. The Tickerbot mobile app calls this automatically on sign-in/foreground — you only call it directly if you are 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 OS-side token refresh never breaks webhooks pointed at the device. App reinstall mints a new token → new device_id (re-pick the device on your webhooks).

Plan access

Included on every plan — but a device only receives anything once a `mobile_push` webhook targets it, and webhooks are paid (Hobby and above).

Rate limit

Hobby 600/min · Pro 6,000/min · Scale 60,000/min.

Body parameters

stringrequired

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

stringrequired

Device platform.

string

Display name for the device picker. Max 60 characters.

Status codes

201
The device record: device_id, deviceName, platform, createdAt, lastSeen. Same shape (200) when the token was already registered.
400
Missing/malformed expoPushToken, invalid platform, or deviceName too long.