Skip to main content

Near Real-Time Device Monitoring

As Hybrid Work & Return to Office trends continue to evolve, so do the collaboration patterns. Therefore, it has become more important than ever to ensure that meeting room devices are up & running always. If a device disconnects from the Poly Lens cloud, it likely means the device has stopped working and is no longer connected to the outside network. As an IT admin, when this happens, especially if it is a VIP room, you’d want to know immediately so that you can take corrective action proactively without waiting for the user to create a support ticket. The deviceStream API does that and more.

The DeviceStream Subscription API

The newly launched deviceStream API is a scalable GraphQL Subscription API that enables real-time monitoring of various key attributes of Poly devices and provides an update when their values change. Most notably this includes the connection status between Poly devices and the Poly Lens cloud. You can use this API to build custom monitoring and alerting based on device connectedness, understand when a device's software has been updated, and much more.

Supported Key Attributes

connected: Connection status between Poly device and Poly Lens cloud.
tenantId: The Poly Lens account identifier of the device.
siteId: Unique identifier of the site.
roomId: Unique identifier of the room. modelId: The unique model name or number of the device.
productId: Product identifier of the device.
id: Unique identifier of the device.
name: The official name of a product without a manufacturer name, e.g. Studio P15.
externalIp: External IP address of the device.
macAddress: Mac address of the device.
hardwareRevision: The revision number of the device's hardware.
softwareVersion: Product software version.
softwareBuild: Unique identifier of the build of the device software. This helps differentiate different builds within the same version.

Important Note: The API stream is engineered to track state changes across multiple devices simultaneously. To prevent exceeding rate limits, it's strongly recommended to use a single API stream to monitor multiple devices. This can be achieved by listing device IDs separated by commas within an array. For details refer to example queries here.

Accessing the deviceStream API

You can access the deviceStream API at the Poly Lens GraphQL Playground. To use this API in your application, you can create credentials in Poly Lens. See How to Get Started.

DeviceStream Operation

Poly Lens GraphQL Subscriptions

At Poly, we’re committed to providing you with all the tools and flexibility you need to create the best collaboration experience for your users and your unique use cases. Our portfolio of nearly 100 officially supported Poly Lens APIs already caters to several use cases such as Inventory Reporting & Management, Device & Room Insights, and Device Controls.

And today, we’re excited to add another dimension to our API portfolio. Announcing, the Poly Lens GraphQL Subscriptions! GraphQL Subscriptions enable you to create web-socket based listeners on fields of your interest so that you get an alert as soon as the value of the field changes. This opens a plethora of new use cases that you can now address using Poly Lens APIs. The first API utilizing the new GraphQL subscription stream focuses on People Counting.

peopleCountStream Subscription API

The peopleCountStream subscription is a simple, yet powerful and versatile API that enables you to monitor room occupancy in near real-time. It creates a web-socket based listener on people count data sent by Poly devices. As soon as people count changes, the API notifies the API user of the change and provides an updated people count for a particular meeting room.

This simple, yet powerful API is designed to show live room occupancy. When combined with custom applications, a variety of different use cases could be enabled, including:

  • Releasing meeting rooms from ghost meetings without waiting for meeting end time
  • Adjusting HVAC and lighting as soon as a room is occupied or vacated
  • Visualizing live room occupancy to create a near real-time view of your meeting rooms

How to Access the peopleCountStream API

You can access the peopleCountStream API at the Poly Lens GraphQL Playground. To use this API in your application, you can create credentials in Poly Lens. See How to Get Started.

peopleCountStream API in action on the Poly Lens GraphQL Playground peopleCountStream API

Note: The peopleCountStream API is available to Poly+ Enterprise customers and currently supports Poly Studio X30, Studio X50, and Studio X52.

We are thrilled to unveil our latest offering — a cutting-edge tool designed specifically for our partners and the Poly Lens developer community. The new Poly Lens API Credential tool has now been expanded to provide access to multiple Poly Lens Accounts using a single set of API credentials. This is designed to revolutionize the way you access and interact with multiple Poly Tenants through the Poly Lens Management and Insights API.

Key Features

Our newly introduced Poly Lens API Credentials come equipped with a range of powerful features tailored to enhance your experience:

  • Muti-tenant API Credentials: Efficiently oversee access multiple Poly Lens Accounts seamlessly via the Poly Lens Management and Insights API using a single unified set of API credentials.
  • Data Extraction and Custom Applications: Extract data from Poly Lens Accounts or craft custom applications to engage with, modify, or generate comprehensive reports using information across multiple Poly Lens Accounts.
  • User-Friendly Creation: Easy creation of API Credentials for your individual Account or for multiple Accounts.
  • Access Requests Management: Grant or deny incoming access requests, ensuring heightened control over data accessibility.

Why It Matters

Our Poly Lens API Credentials are designed to enhance versatility and efficiency, empowering you to streamline operations, leverage data more effectively, and foster innovation. This tool enables seamless data extraction from multiple Lens Accounts and facilitates the creation of custom applications for interaction, modification, or report generation across various Poly Lens Accounts, all accomplished using a single set of API credentials.

Whether you're focused on improving access management or exploring the possibilities of data-driven applications, this tool serves as your gateway to simplifying device management and enabling managed service offerings that harness the power of the Poly Lens platform.

Poly Lens API Credentials example

Get Started Today

The Poly Lens API Credentials are now available, poised to transform the way you navigate and utilize Poly Lens. Get started by going to Go to ACCOUNT menu > Manage Accounts, select and Account from the list and select API Credentials. For more information, visit the Poly Lens Help.

Last year marked a significant milestone for the Poly Lens platform as we introduced the Poly Lens Developer Portal and made the Poly Lens APIs accessible to all. This move opened up exciting opportunities for our developers, our customers, and our partners to create unique collaboration experiences. Since then, the Poly Lens community has been busy building innovative solutions, and today, we're thrilled to announce a new addition to the Poly Lens ecosystem – the AVI-SPL Symphony platform. AVI-SPL Symphony is an award-winning user experience management platform designed to administer, monitor, control, and analyze multi-vendor AV, UC, and meeting environments. AVI-SPL Symphony and Poly Lens creates a powerful toolset focused on asset management, cloud migration, centralized monitoring, incident management, workplace management, and success metrics.

Asset Capture

In the world of technology, managing assets is the first crucial step in ensuring a seamless experience. AVI-SPL Symphony and Poly Lens have streamlined this process, making it easier than ever. With Poly Lens, you can capture information about your devices and structure them efficiently. This not only provides a clear view of your technology assets from a global perspective but also allows you to delve into specific rooms or spaces. This newfound clarity enables organizations to understand their deployments, track works in progress, and prepare for budgetary planning effectively.

Cloud Migration

In the era of cloud migration, integrating legacy and modern technology can be challenging. AVI-SPL Symphony and Poly Lens simplify this transition. The integration of Poly Lens APIs and Symphony allows you to schedule meetings through Outlook, monitor live meetings in Symphony, and gain a deep understanding of technology utilization. This collaboration ensures a smooth transition, regardless of the mix of legacy and newer devices.

Centralized Monitoring

Monitoring the health of your deployment is paramount for ensuring uninterrupted technology experiences. Symphony, with its 24/7 communication capabilities, monitors your AV, VTC, and UCC systems even when you can't. This proactive approach ensures that issues are identified and addressed before they escalate. Symphony consolidates performance data, room information, and meeting statistics from various devices and aggregators, such as Poly Lens, into a single platform for seamless centralized monitoring.

Incident Management

In the unfortunate event that something does go wrong, Symphony is always ready to step in. Whether it's a loss of communication with a device or a critical temperature alert, Symphony can automatically create a ticket for your technical resources based on predefined values. Furthermore, if you use an ITSM system like ServiceNow, Symphony can create a twin ticket, streamlining the incident resolution process. This approach not only ensures swift issue resolution but also provides valuable insights into trends, aiding in future issue prevention.

Workplace Management

Workplace management takes a strategic view of your space, technology assets, and resource utilization. Bringing this data into a single platform alongside Symphony's other functionalities offers a data-driven understanding of your environment. This holistic perspective empowers organizations to optimize their spaces, troubleshoot issues, and make informed decisions.

Success Metrics

Data is a valuable resource, but its true potential lies in its analysis and visualization. Symphony provides interactive dashboards that transform raw data into digestible success metrics. These visual insights enable organizations to make data-driven decisions and leverage historical data for future planning, ensuring continued improvement and excellence in collaboration experiences.

The partnership between AVI-SPL Symphony and Poly Lens brings a new level of sophistication and ease to the management of AV, VTC, and UCC environments. This collaboration empowers organizations to streamline asset management, monitor their technology health, manage incidents efficiently, gain a strategic understanding of their workplace, and utilize success metrics for informed decision-making. The Poly Lens ecosystem continues to evolve, and with AVI-SPL Symphony onboard, it's safe to say that the future of collaboration is looking brighter than ever. Visit here to learn more about AVI-SPL Symphony.

AVI-SPL Symphony example

At the heart of our mission lies a commitment to providing the tools and flexibility needed to enable the best collaboration experiences. In line with this commitment, Poly Lens Integrations just went through an overhaul to make it easier than ever to explore all the possible ways Poly Lens and our ecosystems of partners are able to provide solutions to some of the most challenging issues in today's hybrid work environment.

What's New

A Fresh Approach to Key Integrations

We understand that collaboration is at its best when it's seamless and efficient. Today, we've introduced a brand-new way to explore key integrations developed by HP | Poly. These integrations are meticulously designed to amplify your Poly Lens experience. Notable applications to this roster include integrations with Microsoft Power BI and Microsoft Entra ID, formerly known as Azure Active Directory. These integrations are geared to supercharge your reports and streamline your onboarding experiences.

Partner-Powered Enhancements

In the spirit of enhancing collaboration on all fronts, we're delighted to introduce experiences brought to life by our esteemed partners. These collaborations harness the power of Poly Lens to its fullest extent. With AVI-SPL Symphony, Neowit, Ubiqisense, and Vyopta, there is likely a solution that caters to your unique needs. Discover a world of possibilities as you explore these cutting-edge integrations.

Important Changes

We've also streamlined the location of some critical features. Power BI and Microsoft Entra ID (formerly Azure Active Directory) have found a new home in our Integration section.

Check it Out

Poly Lens Integrations revamp isn't just an update; it's a leap forward. With these integrations, we're making your Poly Lens experience more intuitive, more efficient, and more powerful than ever. Go to the Admin menu icon Admin menu > Integrations to explore the new Integrations page.

Integrations page

We have added more than 50 new officially supported APIs to the Poly Lens API Portfolio. There are now almost a hundred Poly Lens APIs that are available publicly and are officially supported by Poly.

In December 2022, we opened the Lens Management & Insights API to our developer community. And now, we have taken our API portfolio to the next level by adding several highly useful APIs for:

  • Inventory Reporting & Management
  • Device & Room Insights
  • Platform Management
  • Device Control
  • Device Software

The guiding principle of the Poly Lens Management and Insights API is to provide our developer community with opportunities to innovate and create in ways that continue to build new experiences, making collaboration easier for everyone by leveraging our platforms. Whether you are an independent developer, enterprise developer, solution provider, or system integrator, you can take advantage of the intelligent insights and management capabilities offered on the Poly Lens platform to optimize your workflows, build custom applications, or extract the data from Lens in a way that works for your organization.

The new APIs not only cover several new use cases but also enable developers to dive deeper into those covered previously. Here are all the use cases covered by the officially supported Poly Lens APIs:

Use Case CategoryUse Cases
Inventory Reporting & Management- Notifications Center New icon
- Custom Devices Tags New icon
- Inventory Reporting
- Room & Site Management
- Subnet Management
Device & Room Insights- Call & Meeting Records New icon
- Device Utilization
- Room Occupancy & Utilization
Platform Management- User Management
- Tenant Management
Device Control- Device Logs New icon
- Software Updates New icon
- Reboot & Reset Device
- Call Control
- Device Registration
Device Software- Device software New icon

All the APIs are documented at the Poly Lens Developer Portal. The depth and breadth of covered use cases showcase the power of the Poly Lens Management & Insight APIs - enough to hopefully get you started with exploring these APIs on the Poly Lens API Playground. To make it easier for you to spot officially supported APIs, we have highlighted the officially supported APIs as such on the Poly Lens GraphQL Playground. See the screenshot below.

Query charts example

We'll continue to expand our portfolio of supported APIs to cover more & more use cases. In the meantime, if you have specific content requests or questions, reach out to

Ubiqisense & Vyopta Integrate Poly Lens APIs with their Platforms

As the hybrid work model continues to evolve, companies are on the lookout for insights to improve the workplace experience to entice employees to the office. Workplace cubicles are no longer the norm, and employees’ preferences are various. While some might prefer open & informal huddle workspaces, there are a few who prefer the quiet offered by small rooms & individual desks. There is no one-size-fits-all. According to research by Gensler (a global architecture, design, and planning firm), organizations are realizing the need to make the workplace into a destination rather than an obligation.

Right-sizing office space can help companies reduce their carbon footprint and achieve compliance with environmental sustainability goals. And lastly, companies are also realizing that there are enormous savings to be made by optimizing real estate utilization. Whatever the case, to make effective decisions, companies would need data & insights into how their office spaces are being utilized. Which is why Poly has partnered with Ubiqisense and Vyopta.


Ubiqisense is a leader in space utilization analysis & insights. Through its solution, it can provide insights into occupancy, usage patterns & footfall across office floors, meeting rooms, open spaces & shared desks.

Ubiqisense is a leader in space utilization analysis & insights dashboard


Vyopta is a digital collaboration experience management company. It provides insights into room utilization, helps identify inefficient meetings, and enables you to take action to prevent costly repetition, repurpose existing resources, and plan for new build-out.

Poly enabled room utilization window

The Poly Advantage

Through its hardware & software innovation, Poly continues to go the extra mile to bring unique value to its customers. People counting sensors can cost anywhere between USD 1K- 3K. However, Poly’s Studio X30, X50 & X52 have these sensors built in. That’s a direct cost saving for customers. People counting data from these devices is readily available via Poly Lens APIs. This data is quite helpful for analyzing office space utilization on platforms such as Ubiqisense & Vyopta.

Through Poly Lens APIs, you can take advantage of the intelligent insights and management capabilities offered on the Poly Lens platform to optimize your workflows, build custom applications, or extract the data from Poly Lens in a way that works for your organization. The Poly Lens APIs are documented at the Poly Lens Developer Portal.

We have now officially opened the Lens Management and Insights API to our developer community. The guiding principle of the new Lens Management and Insights API is to provide our developer community opportunities to innovate and create in ways that continue to build new experiences, making collaboration easier for everyone by leveraging our platforms. Whether you are an independent developer, enterprise developer, solution provider, or system integrator, you have the opportunity to take advantage of the intelligent insights and management capabilities offered on the Poly Lens platform to optimize your workflows, build custom applications, or extract the data from Lens in a way that works for your organization.

Built using GraphQL, the Lens Management and Insight API supports all the features you see in the Poly Lens Portal. Visit our new API Marketplace to get support, share ideas, and see a few examples of common use cases such as reporting device inventory, controlling device state, and platform management. There you will also be able to access the built-in API playground to learn, understand, and experiment with each API. Once you are ready to start building, you can easily create API credentials right in Lens. Use these credentials to get an access token that can be used to grant access to a particular tenant.

Ready to start building a custom application using the Lens APIs? Visit our API Guide to get started. We can’t wait to see what you create.