Register Device

View as Markdown

Register a new device for push notifications. URL’s {{user_id}} must equal the authenticated user’s UUID — registering on another user’s path returns 403. Upserts on (user_id, device_token): if the token already exists for this user, updates platform, device_name, sets is_active=true, and refreshes last_active_at. Returns 201 with the device resource.

Headers

{{tenant_key_name}}stringOptional

Request

This endpoint expects a multipart form.
platformstringRequired

Required: Device platform - ios|android|web - “ios”

device_namestringRequired

Optional: Human-readable device name - max 255 chars - “Mike’s iPhone”

device_tokenstringRequired

Required: Push notification device token from FCM/APNs/Beams - string max 512 chars - “fcm_abc123…”

Response

Successful response