Add a Phone

Problem

Your application needs to add a new phone to Cisco Unified CM.

Solution

Cisco UC Manager Version: 8.5

Use the addPhone AXL API to add a new phone to Unified Communications Manager.

Step 1: Add phone and specify required and optional information.

The phone name is the only required field, but you can specify many other attributes and associate lines, speed dials, services and more in the addPhone request. In this example, we specify several attributes of the phone and also associate a line. The addPhone response returns the uuid of the new phone.

addPhone
Request Response
                            <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.cisco.com/AXL/API/8.5">
                               <soapenv:Header/>
                               <soapenv:Body>
                                  <ns:addPhone sequence="?">
                                     <phone ctiid="?">
                                        <name>SEPE8B7480316D7</name>
                                        <description>John Smith - Office</description>
                                        <product>Cisco 6961</product>
                                        <class>Phone</class>
                                        <protocol>SCCP</protocol>
                                        <protocolSide>User</protocolSide>
                                        <callingSearchSpaceName uuid="?">Generated_CSS_I_E</callingSearchSpaceName>
                                        <devicePoolName uuid="?">Default</devicePoolName>
                                        <lines>
                                           <line ctiid="?">
                                              <index>1</index>
                                              <label>?</label>
                                              <display>?</display>
                                              <dirn uuid="FB67F928-11EF-9500-58EA-DFC6BA9BC042">
                                              </dirn>
                                              <ringSetting>Ring</ringSetting>
                                              <consecutiveRingSetting>Use System Default</consecutiveRingSetting>
                                              <e164Mask></e164Mask>
                                              <mwlPolicy>Use System Policy</mwlPolicy>
                                           </line>
                                        </lines>
                                        <phoneTemplateName uuid="?">Standard 6961 SCCP</phoneTemplateName>
                                        <speeddials>
                                           <speeddial>
                                              <dirn>919995559999</dirn>
                                              <label>My Broker</label>
                                              <index>1</index>
                                           </speeddial>
                                        </speeddials>
                                        <services>
                                           <service>
                                              <telecasterServiceName uuid="?">Demo</telecasterServiceName>
                                              <name>Demo</name>
                                           </service>
                                        </services>
                                        <softkeyTemplateName uuid="?">Standard User</softkeyTemplateName>
                                        <enableExtensionMobility>false</enableExtensionMobility>
                                     </phone>
                                  </ns:addPhone>
                               </soapenv:Body>
                            </soapenv:Envelope>
	
                            <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
                               <soapenv:Body>
                                  <ns:addPhoneResponse xmlns:ns="http://www.cisco.com/AXL/API/8.5">
                                     <return>{8C3677AB-7556-A407-ECAD-5A5B18C6D0C5}</return>
                                  </ns:addPhoneResponse>
                               </soapenv:Body>
                            </soapenv:Envelope>