Select Page

Sending CUPI requests to Cisco Unity using Postman

Sean McDade

The Cisco Unity Provisioning Interface (CUPI) allows a UC Administrator to programmatically perform moves, adds, and changes to various entries in Cisco Unity (users, contacts, distribution lists, and call handlers) through a simple REST API.

The following article will provide instructions on how to perform a request to the CUPI API using Postman.

Prerequisite: Administrator Account in Cisco Unity. 

To use the Unity’s CUPI API, you will require an Administrator Account.  If you already have an Administrator Account in Cisco Unity, you may skip this section.

Section 1) Creating an administrator account in Cisco Unity 

Step 1.1: Login to the Cisco Unity Connection Administration page.

Login to the Cisco Unity Connection Administration page.png

 

Step 1.2: Go to Users.

Sending CUPI requests to Cisco Unity using Postman 2 from Stack8.png

 

Step 1.3: Click on Add New.

Sending CUPI requests to Cisco Unity using Postman 3 from Stack8.png

 

Step 1.4: Click on the User Type dropdown and select the User Without Mailbox type.

Sending CUPI requests to Cisco Unity using Postman 4 from Stack8.png

 

Step 1.5: Click on the Based on Template dropdown and select the administrator template.

Sending CUPI requests to Cisco Unity using Postman 5 from Stack8.png

 

Step 1.6: Provide a new user alias.

Sending CUPI requests to Cisco Unity using Postman 6 from Stack8.png

 

Step 1.7: Click Save.

Sending CUPI requests to Cisco Unity using Postman 7 from Stack8.png

 

Step 1.8: Now that the user has been created, ensure to Edit — Change Password to provide credentials for your newly created account.

Sending CUPI requests to Cisco Unity using Postman 8 from Stack8.png

Section 2) Sending a CUPI request to Cisco Unity with Postman

For our example, we will request a user’s information using an account alias.
Refer to the Cisco Unity Connection Provisioning Interface (CUPI) API for the full list of possible transactions.

Step 2.1: Open Postman (Available at https://www.getpostman.com/)

 

Step 2.2: Select GET from the request dropdown menu.

Sending CUPI requests to Cisco Unity using Postman 9 from Stack8.png

 

Step 2.3: In the URL tab, provide the URL to query the user by alias (replace the IP and alias with your values)

https://<ip-or-hostname-to-cuc>/vmrest/users/?query=(alias is alias)

Step 2.4: Go to the Authorization tab and select Basic Auth.

Sending CUPI requests to Cisco Unity using Postman 12 from Stack8.png

 

Step 2.5: Provide the credentials for the System Administrator user you created in Unity and click Update request.

Sending CUPI requests to Cisco Unity using Postman 10 from Stack8.png

 

Step 2.6: Press Send and then review the returned XML response containing the details of the voicemail account.

Sending CUPI requests to Cisco Unity using Postman 11 from Stack8.png

 

Congratulations! You have successfully sent a CUPI API request to your CUC using Postman. If you are interested in building solutions to help your organization with their UC environment using CUPI, please feel free to reach out to our Software Solutions Team. Our team of experts uses AXL and CUPI extensively for a variety of software products, including SMACS our Stack8, Moves, Adds, and Changes Solution.

 

 

January 24, 2017

Sean McDade