---
title: "Create device"
method: POST
path: "/v4/accounts/{voip_id}/devices"
tags: ["Devices"]
---

# Create device

`POST /v4/accounts/{voip_id}/devices`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/devices`
- Auth: HTTP bearer

The Create Device API allows you to add a Generic SIP device. You may use the extension API to associate the device with the extension, which is required for the device to be operational.  NOTE: If you use the Create Device and at the same request, ask to associate the device to an extension (using the "Lines" Param). The Call Handling Rules (CHR) of the Extension, if existed, will be deleted. 

To ensure proper operation of the SIP device, you must add some call handling rules to the extension. Adding CHR is usually done by using the extension API.

## Path parameters

- `voip_id` integer, required

## Request body

- Device
  - `name` string, nullable: Device Name
  - `lines` object[], nullable: Array of Line Objects showing which extensions are attached to this device, and their assigned line numbers
    - `line` integer, required: Line number
    - `extension` object, required: Extensions object that this line number is mapped to
      - `id` integer, nullable: ID of the extension. This is the internal Phone.com ID, not the extension number callers may dial.
      - `extension` integer, nullable: Extension number that callers may dial. On POST, leaving this empty will result in an auto-generated value. On PUT, this field is required.
      - `name` string, nullable: User-supplied name for the extension. On POST, leaving this empty will result in an auto-generated value. On PUT, this field is required.
  - `code` integer, nullable: Device Code (available for special integrations only)
  - `address` object, nullable: Address associated with this device for 911 calls
    - `line_1` string, required: Address line 1
    - `line_2` string, required: Address line 2
    - `city` string, required: City
    - `province` string, required: Contact province
    - `postal_code` string, required: Contact postal code
    - `country` string, required: Country name

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)