---
title: "Add Device"
method: POST
path: "/notification/add-device"
tags: ["Notifications"]
---

# Add Device

`POST /notification/add-device`

Call to add or register a device for notifications. This endpoint allows clients to register a device by providing its details such as device ID, FCM ID, app version, and other relevant information. The registered device will be used to send notifications. The request body must contain the device payload information.

## Request body

- AddDeviceRequest — The request body must contain the device payload information. The format should be:
  - `devicePayload` object
    - `app-id` string — Would be a enum describing the platform in use. Allowed Enums - android, ios
    - `app-platform` string — The platform on which the application is running (e.g., Android, iOS).
    - `app-version` string, required — This helps us in Notifications to trigger based on App Version compatibility. Should be a string convertible integer for android and string convertible float for iOS.
    - `did` string, required — Device ID any unique id where we can identify a device.
    - `fcm-id` string, required — The Firebase Cloud Messaging identifier for the device.
    - `fid` string — The Firebase Installation identifier.
    - `lang` string — The language setting of the device.
    - `os-version` integer — The operating system version of the device.
    - `user-hash` string — A hash representing the user, can be empty if not applicable.

## Response `200`

Successful response

- object

## Other responses

- `400` — Client error response
- `500` — Server error response

---

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