Webex People API Updates
September 15, 2022There are always new features coming to the Webex REST API; this update covers a few recent additions to the People endpoint used for interacting with Webex user data. Read along to get the full scoop on the new, extended, functionality.
Add People Smarter
Now, Webex REST API accepts new fields to describe people. Here’s a full list of the added fields:
- PhoneNumbers
- Department
- Manager
- Title
- Country
- City
Support for these fields cannot be overstated, due to its role in making Webex People API a powerful tool for Admins to use for onboarding employees! All an admin
needs to do is first disable Directory Connector to unlock this new potential. Any Webex user with the admin
role (in production or a sandbox) can give this a try right away, or just read more information here: Create a Person.
Feature Subtraction: Data Security Edition
At one time, it was possible to use Webex People API to look up people across organizations using only an email address. Because this type of public directory had the potential to be exploited, it has been disabled. Also, an id
is now required for user to GET
a person’s details. This neutralizes any looming security threat, with the added possibility of less unwanted messages. However, users looking for messaging functionality specifically may continue to send POST
requests with recipient’s email address to the /messages
endpoint. Read about what it takes to GET
personal details in our documentation here: List People.
Added Support for EVERYONE
Webex’s client applications allow users to set their preferred pronouns easily and choose whether to have them displayed to others. Soon, Webex REST API will return this information via a simple GET
request to /people/{personId}
. The value of inclusivity in the workplace is priceless! Coming in November, this feature must be enabled by an organization’s admin through Control Hub. Then, pronouns must be set using the Webex native client before People API can return them.
Try It Yourself
Webex REST API’s range of dynamic features may inspire you to build an app of your own using the Webex Platform. To try out the features discussed in this blog, you’ll need a Developer Sandbox account. Then, you can try samples and learn all about Webex People API in our Developer Portal here: People.
TL;DR
Here’s a video summary of these updates to Webex REST API.
Keep Up with Us
Stay in the loop with our social pages
Follow us on Twitter
Watch Our Collection on Vidcast.io
Dive deeper
Join the conversation