Add a desk phone by MAC address: creates its line, registers the phone, and seats it in the team ring group so it rings with the team and unanswered calls reach Kai. Refused (409 e911_address_required) until the office address is validated. Owner role (session) or numbers:write.

post/v1/phone-system/desk-phones

Request

  • Base URL: https://www.kaicalls.com/api
  • URL: https://www.kaicalls.com/api/v1/phone-system/desk-phones
  • Auth: HTTP bearer

Request body

business_idstring required
mac_addressstring
namestring
action'refresh' | 'attach_emergency_location' required

Send 'refresh' with device_id to reload settings. Send 'attach_emergency_location' to attach the provisioned main office location only when the phone has no location; existing locations are preserved. Both require owner role or numbers:write.

device_idstring required

Example request

{
  "mac_address": "00:04:13:aa:bb:cc",
  "name": "Front Desk"
}

Response

Phone added, settings reload requested, or emergency location verified by readback

Changes

No recorded changes to this operation across all 1 revision of this API.