---
title: "POST /v0.1/users/{user_id}/devices/register"
method: POST
path: "/v0.1/users/{user_id}/devices/register"
tags: ["distribute"]
---

# POST /v0.1/users/{user_id}/devices/register

`POST /v0.1/users/{user_id}/devices/register`

Registers a user for an existing device

## Path parameters

- `user_id` string, required

## Request body

- object — The information for a single iOS device
  - `udid` string, required — The Unique Device IDentifier of the device
  - `model` string, required — The model identifier of the device, in the format iDeviceM,N
  - `os_build` string — The build number of the last known OS version running on the device
  - `os_version` string — The last known OS version running on the device
  - `serial` string — The device's serial number. Always empty or undefined at present.
  - `imei` string — The device's International Mobile Equipment Identity number. Always empty or undefined at present.
  - `owner_id` string — The user ID of the device owner.

## Response `200`

Success

- object — The information for a single iOS device
  - `udid` string, required — The Unique Device IDentifier of the device
  - `model` string, required — The model identifier of the device, in the format iDeviceM,N
  - `device_name` string, required — The device description, in the format "iPhone 7 Plus (A1784)"
  - `full_device_name` string — A combination of the device model name and the owner name.
  - `os_build` string, required — The last known OS version running on the device
  - `os_version` string, required — The last known OS version running on the device
  - `serial` string — The device's serial number. Always empty or undefined at present.
  - `imei` string — The device's International Mobile Equipment Identity number. Always empty or undefined at present.
  - `owner_id` string — The user ID of the device owner.
  - `status` string, required — The provisioning status of the device.
  - `registered_at` string — Timestamp of when the device was registered in ISO format.

## Other responses

- `404` — <b>not_found</b>: The user or the device can't be found.

---

[API](https://skmtc.net/appcenter/apis/app-center-client.md) · [All operations](https://skmtc.net/appcenter/apis/app-center-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appcenter/app-center-client/versions/4e9226ab8f35/schema)