# Add device for notifications

Add a new device to enable communication and push notification delivery for the authenticated user.

Endpoint: POST /notifications/devices/add-device
Version: 1.0
Security: bearerAuth

## Header parameters:

  - `x-fingerprint-id` (string, required)
    Unique device or session fingerprint identifier used for security and fraud prevention.

## Request fields (application/json):

  - `deviceId` (string, required)
    Unique identifier of the device.
    Example: "device-9f8c1a"

  - `platform` (string, required)
    Platform where the device is running.
    Enum: "android", "ios", "web"

  - `environment` (string, required)
    Application environment where the device is registered.
    Example: "production"

  - `pushToken` (string, required)
    Push notification token generated by the platform provider.
    Example: "eJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.mocktoken"

  - `mobileSettings` (object)
    Mobile-specific device settings. Required for mobile platforms.

  - `mobileSettings.appInstanceId` (string)
    Example: "app-instance-8831"

  - `mobileSettings.appVersion` (string)
    Example: "3.1.0"

  - `mobileSettings.osVersion` (string)
    Example: "17.2"

  - `mobileSettings.deviceModel` (string)
    Example: "iPhone 15"

  - `webSettings` (object)
    Web-specific device settings. Required for web platform.

  - `webSettings.userAgent` (string)
    Example: "Mozilla/5.0 (Macintosh; Intel Mac OS X)"

  - `webSettings.ipAddress` (string)
    Example: "192.168.0.10"

## Response 200 fields (application/json):

  - `statusCode` (integer)
    Example: 200

  - `data` (object)

  - `data.device` (object)

  - `data.device.id` (string)
    Example: "65dcb1e4a3f19a0021b7c890"

  - `data.device.createdAt` (string)
    Example: "2026-01-29T15:10:22.120Z"

  - `data.device.updatedAt` (string)
    Example: "2026-01-29T15:10:22.120Z"

  - `data.device.deleted` (string)

  - `data.device.userId` (string)
    Example: "3baf91f2-2c7d-4a2a-9c9d-8e3a4b9c120a"

  - `data.device.deviceId` (string)
    Example: "device-9f8c1a"

  - `data.device.platform` (string)
    Enum: "android", "ios", "web"

  - `data.device.lastUsedAt` (string)
    Example: "2026-01-29T15:10:21.980Z"

  - `data.device.status` (string)
    Enum: "active", "revoked"

  - `data.device.environment` (string)
    Example: "production"

  - `data.device.lastSeenAt` (string)
    Example: "2026-01-29T15:10:21.980Z"

  - `data.device.pushToken` (string)
    Example: "eJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.mocktoken"

  - `data.device.mobileSettings` (object)

  - `data.device.mobileSettings.appInstanceId` (string)
    Example: "app-instance-8831"

  - `data.device.mobileSettings.appVersion` (string)
    Example: "3.1.0"

  - `data.device.mobileSettings.osVersion` (string)
    Example: "17.2"

  - `data.device.mobileSettings.deviceModel` (string)
    Example: "iPhone 15"

  - `data.device.webSettings` (object)

  - `data.device.webSettings.userAgent` (string)
    Example: "Mozilla/5.0 (Macintosh; Intel Mac OS X)"

  - `data.device.webSettings.ipAddress` (string)
    Example: "192.168.0.10"

## Response 400 fields (application/json):

  - `message` (string)
    Invalid param: []
    Example: "Invalid param: []"

  - `error` (string)
    Bad Request
    Example: "Bad Request"

  - `statusCode` (integer)
    400
    Example: 400

## Response 401 fields (application/json):

  - `message` (string)
    Invalid field
    Example: "Unauthorized"

  - `error` (string)
    Unauthorized
    Example: "Unauthorized"

  - `statusCode` (integer)
    401
    Example: 401

## Response 403 fields (application/json):

  - `message` (string)
    Forbidden resource
    Example: "Forbidden resource"

  - `error` (string)
    Forbidden
    Example: "Forbidden"

  - `statusCode` (integer)
    403
    Example: 403

## Response 500 fields (application/json):

  - `message` (string)
    Internal server error
    Example: "Internal server error"

  - `error` (string)
    Internal Server Error
    Example: "Internal Server Error"

  - `statusCode` (integer)
    500
    Example: 500