Crestron XiO Integration Guide

This document serves as a comprehensive guide that outlines the steps required to integrate Crestron devices with the NetSpeek platform via Crestron XiO Cloud.

Note

There are two paths for integrating Crestron devices with NetSpeek – the XiO Cloud Connector documented on this page, and the CresNext Connector via the Edge VM at a device’s local IP address documented at Crestron CresNext Integration Guide. Some organizations may want to use one method or the other, while some may want to orchestrate Crestron devices in their environment with both methods in parallel. Contact your NetSpeek representative to discuss this decision in more detail.

Prerequisites

Before beginning, confirm the following:

  • Crestron devices are already enrolled in Crestron XiO Cloud and connected to your organization.
  • You have Global Administrator (or equivalent permissions required by Crestron to enable API access) to your XiO Cloud portal.
  • You have access to your NetSpeek tenant with permission to manage Connectors.
  • XiO Cloud API access is licensed for your account (commonly referenced as the SKU identifier SW-XIOC-API; confirm with Crestron or your distributor).
    • XiO Cloud Premium is required for some API capabilities – confirm your organization’s current entitlements with Crestron if necessary.

Terminology change, October 2026

The device and tenant level “Connector” configurations were previously called “Integration” and have been renamed in both the NetSpeek portal interface, and NetSpeek Docs.

Step 1. Enable XiO Cloud API access and generate credentials

Crestron’s Enable API Access documentation guides the XiO Cloud administrator through enabling the public REST API. This NetSpeek guide assumes devices are already enrolled and operational in XiO Cloud – the steps below describe how to enable the necessary API settings (or verify they are already enabled) in XiO Cloud.

In the XiO Cloud web portal (logged in with Global Administrator permissions):

  1. Open Settings (gear) → Account Settings → Profile.
  2. Expand Details.
  3. Turn on Enable API Access.
  4. Enter the administrator name and email when prompted.
  5. Select Save Changes. Copy the Api Subscription Key when shown.
  6. Copy/store your XiO Account ID (issued with API onboarding, and shown in the portal as per the example image below) as this will also be needed for the NetSpeek configuration in the following step.

If self-service configuration of Enable API Access is unavailable, contact Crestron Technical Support or your Crestron representative to enable API access for your XiO Cloud tenant.

Store the Api Subscription Key and Account Id according to your organization’s policies – they will need to be entered into your NetSpeek tenant in the following step.

Step 2. Configure Crestron XiO Cloud in NetSpeek (Tenant Connector)

  1. Ensure you have selected the desired tenant/sub-tenant with the selector in the upper left of the portal interface, and click “Connectors” in the Platform configuration list at the lower left.
  2. Click “+ Add Connector”
  3. Enter a Connector Name (as an example format, Crestron XiO – YourOrgName - YourTenantID).
  4. Set Connector Type = Crestron XiO Cloud.
  5. (Optional) Enter a description, with details other NetSpeek users may need to know.
  6. Set Connector State = Active.
  7. Enter the following configuration values:
    • API Key: The XiO Api Subscription Key from Step 1
    • Account Id: The XiO Account ID from Step 1
  8. Click Create new Connector / Update Connector.

Step 3. Add Device to NetSpeek Room Canvas

  1. From a new WorkSpace, select Locations and search for or navigate to the Room the device will reside in.
  2. Select the room you wish to add your Crestron device to
  3. The Room Canvas opens by default.
  4. Click “Add Devices” and then “Create new“
  5. Choose your desired device from the manufacturer → device model list.
  6. Configure the appropriate values, and in the “Connectors” section, select the previously created XiO Cloud integration from Step 2.
  7. In the configuration panel, enter the following fields:
    • Serial Number (this is the only required parameter for XiO Cloud integration)
    • The example below shows multiple Connectors configured for the same device – first, the XiO Cloud Connector communicating with the device via Crestron’s cloud, and second, the CresNext Connector communicating with the device via the NetSpeek Edge VM.

Verification

Once the relevant settings described above are configured, to validate the Connector:

  • Select a Crestron device in the NetSpeek console, open the Device Actions Tab, and select an available device action. It is generally advisable to test by dispatching a non-intrusive command such as a Get Status.
  • On the device, observe the selected action occurring.

Support

If you run into any issues during onboarding or have questions, contact NetSpeek Support at support@netspeek.com.