---
title: "Register a mobile device for push notifications"
method: POST
path: "/v1/devices"
tags: ["Devices"]
---

# Register a mobile device for push notifications

`POST /v1/devices`

## Request

- Base URL: `https://identity-api.paymongo.com`
- URL: `https://identity-api.paymongo.com/v1/devices`
- Auth: HTTP bearer

Registers (or refreshes) the caller's device push token. Called right after login and on every app launch since FCM/APNS tokens rotate. Creates or re-points the SNS platform endpoint and upserts the device row keyed on the device token.

## Request body

- DeviceRegisterDeviceRequestEnvelopeDTO
  - `data` object
    - `attributes` DeviceRegisterDeviceRequestDTO
      - `app_version` string
      - `device_token` string, required
      - `platform` 'ios' | 'android', required

## Response `201`

Created

- object: Standard response containing data and its metadata if any
  - `data` object
    - `attributes` DeviceRegisterDeviceAttributesDTO
      - `app_version` string
      - `enabled` boolean
      - `platform` string
    - `id` string
    - `type` string
  - `has_more` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error
- `502`: Bad Gateway

---

[API](https://skmtc.dev/paymongo/apis/identity.md) - [All operations](https://skmtc.dev/paymongo/apis/identity/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/identity/revisions/cc3056164874?raw)