---
title: "Add device token for user"
method: POST
path: "/api/notifications/v1/tokens"
tags: ["User Management Notification"]
---

# Add device token for user

`POST /api/notifications/v1/tokens`

Registers a new device token for the authenticated user. If the token already exists, updates its association or last set time as appropriate. Used for enabling push notifications to the user's device.

## Headers

- `request-id` string

## Request body

- AddDeviceTokenRequest
  - `deviceToken` string, required
  - `provider` 'fcm', required
  - `platform` 'ANDROID' | 'IOS', required
  - `appId` string, required

## Response `201`

Device token added

- AddDeviceTokenResponse
  - `deviceToken` string, required
  - `platform` 'ANDROID' | 'IOS', required
  - `provider` 'fcm', required
  - `appId` string, required
  - `bitgoUserId` string, required
  - `message` string, required

## Other responses

- `400` — Invalid device token request body
- `500` — Unexpected error

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)