HOWTO: Get Webroot Endpoints using Unity REST API and PowerShell

Webroot has recently released a new REST API that allows us as administrators to pull detailed endpoint data programmatically. What this effectively means is that all of the information that is presented to us in the Webroot Global Site Manager can now be extracted directly and integrated into other processes. I very much wanted a script that would be able be able to run on a scheduled task and compare all the systems in Active Directory with those registered in Webroot and then report on those AD systems that either do not have Webroot installed or haven’t checked in for more than a week.

It took some reading and trial and error but I managed to create a PowerShell script that can connect to Webroot and pull all of the details for every endpoint for a given keycode into an object which you can then do whatever you want with. I figured I’d save you the frustration of figuring out how to make this. Of course this code is presented as is. It’s working for me but your mileage may vary.

Here’s how it works:

1) You specify the Keycode you want to report on and provide your regular end user credentials as well as a special API client ID and password which you can create in the GSM
2) The script will then request a REST API token which is valid for 300 seconds
3) It will then use that token to request the siteID of the specified keycode
4) It will then use that siteid to grab all of the endpoints and their details for every endpoint associated with the given keycode and display the results

If you find this useful, let me know in the comments.


    • Josh on January 17, 2017 at 8:21 pm
    • Reply

    This is great work, thank you! I did find an error on line 24 – instead of $APIUsername it should read $APIClientID

    • Boris on September 29, 2017 at 2:52 pm
    • Reply

    Hello, thankyou for the script. It was a good basis for me. With multiple Sites, the code needs to be adjusted a bit (GSM Masterkeycode and Site Keycode)

    Rg. Boris

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.