---
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`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/users/{user_id}/devices/register`
- Auth: API key in header `X-API-Token`
- TypeScript: <https://skmtc.dev/appcenter/apis/app-center-client/docs/v0.1/users/:user_id/devices/register/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/appcenter/apis/app-center-client.md) - [All operations](https://skmtc.dev/appcenter/apis/app-center-client/llms.txt) - [OpenAPI document](https://skmtc.dev/appcenter/apis/app-center-client/revisions/4e9226ab8f35?raw)