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

---

Prerequisites

Before beginning the integration, 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 Integrations.
• 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.

---

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 integration 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 Integration)

1. In the NetSpeek portal, navigate to Tenant Management (settings cog icon)→ Integrations within your desired tenant (you may have access to multiple tenants / sub-tenants – if so, ensure you are configuring the integration in the proper place).
2. Click “+ Add Integration”
3. Enter an Integration Name (as an example format, Crestron XiO – YourOrgName - YourTenantID).
4. Set Integration Type = Crestron XiO Cloud.
5. (Optional) Enter an Integration description, with details other NetSpeek users may need to know.
6. Set Integration 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 integration / Update integration.

Step 3. Add Device to NetSpeek Room Canvas

1. In the NetSpeek Console, navigate to Room Management
2. Select the room you wish to add your Crestron device to
3. Click Launch Room Canvas
4. Click Add device to room
5. Choose your desired device from the manufacturer → device model list.
6. Configure the appropriate values, and in the “Integrations” section, select the previously created XiO Cloud integration from Step 2.
   • Serial Number (this is the only required parameter for XiO Cloud integration)

---

Verification

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

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