Register or update FCM device token

PUT

/api/v1/device-token

Register or update the Firebase Cloud Messaging (FCM) token for the current device.
This token is used to send push notifications to iOS and Android devices.
The device is identified by the JWT access token (device_token claim).

Should be called:

After login/token refresh when the FCM token is available

When the FCM token is refreshed by the Firebase SDK

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Device token registered successfully

Bodyapplication/json

🟠404

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/api/v1/device-token' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "device_token": {
        "fcm_token": "dKJ8f3kL9m:APA91bH...",
        "platform": "android"
    }
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "message": "Device token registered successfully"
    }
}

Modified at 2026-06-08 00:59:16

Mark notification as read

Remove FCM device token