Add phone

POST

/phones

Last modified:2026-10-30 20:56:01

OperationId:CreatePhone

Adds a phone to the Endpoints server inventory by MAC address, so it can download its configuration, and assigns devices to its lines. Requires Site Manager, Office Manager, Reseller, or Super User scope, or a user scope adding a phone with its own device on line 1. A Site Manager can put only a device of a user in its site on line 1.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after. For Yealink, Polycom, Snom, Fanvil, Grandstream, and Htek phones, the MAC address is also registered with the vendor's zero-touch provisioning service when the platform has one configured.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠409Conflict

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

cURL

Phone with line 1Separated MAC address

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/phones' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device-provisioning-mac-address": "00005e005301",
    "domain": "example.com",
    "device-models-brand-and-model": "Yealink T54W",
    "device-provisioning-sip-uri-1": "sip:1001a@example.com",
    "device-provisioning-sip-transport-protocol": "udp",
    "notes": "Front Desk"
}'

Response Example

202 - Phone with line 1

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-30 20:56:01

Read phone in domain

Add phone in domain