---
title: "Add Phone to Inventory"
method: POST
path: "/restapi/v2/accounts/{accountId}/device-inventory"
tags: ["Devices"]
---

# Add Phone to Inventory

`POST /restapi/v2/accounts/{accountId}/device-inventory`

Adds an existing phone (customer provided device - BYOD) as an unassigned device to the account inventory.

## Path parameters

- `accountId` string, required

## Request body

- AddDeviceToInventoryRequest
  - `type` 'OtherPhone', required — Device type. Use `OtherPhone` to indicate BYOD (customer provided) device
  - `quantity` integer, required — Quantity of devices (total quantity should not exceed 50)
  - `site` object
    - `id` string — Site extension identifier or "main-site" for the main site

## Response `201`

Created

- AddDeviceToInventoryResponse
  - `devices` object[], required
    - `id` string, required — Internal identifier of a created device
  - `site` SiteBasicInfo, required
    - `id` string, required — Site extension identifier or "main-site" for the main site
    - `name` string, required — Site name

## Other responses

- `400` — General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `403` — General response with **HTTP 403 "Forbidden"** status.<br> Reasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.
- `404` — General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `429` — General response with **HTTP 429 "Too many requests"** status.<br> Reasons: certain rate limit is exceeded.
- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503` — General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)