Sending CUPI requests to Cisco Unity using Postman

Posted by Sean McDade on Jan 24, 2017 8:11:24 AM

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

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 administratortemplate.

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 http://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.

Don’t miss out receive expert advice straight to your inbox!

Subscribe to our blog today!

 

 

 

Topics: Cisco Unity, SMACS, Cisco Unity Provisioning Interface, postman

Don’t miss out. Expert advice straight to your inbox!

Insightful tips, troubleshooting and solutions for your everyday Unified Communications challenges from our team of experts. You can look forward to:

  • Weekly UC tips;
  • Cisco Unified Communications insights;
  • UCCX - Contact Center insights;
  • Network and Security insights;
  • Cisco Release notes and Product reviews.
Join us for free live demo