Shure
Shure connector setup guide.
Temporarily unavailableNew Shure connectors can't be added right now while we resolve a rate-limiting issue with Shure Cloud. In the connector catalogue the Shure card shows Coming Soon and can't be selected. Existing Shure connectors stay in place, but may not sync devices until this is resolved. We'll update this page when the connector is available again.
| Syncs | Shure microphones (MXA-class) |
| Authentication | Cloud credentials |
| Direction | Inbound — imports devices into Connect+ |
Connects Shure networked microphones for monitoring.
Prerequisites
To use the ShureCloud REST API with Xyte, make sure you have:
- Required account / tenant: A ShureCloud organization, accessed with a My Shure ID.
- Required access: API access enabled for your organization, with permission to create API integrations / applications.
- Required plan / license: Depends on your ShureCloud deployment and entitlements.
- Where to verify: ShureCloud organization → Organization Settings > ShureCloud API.
Status and sync
-
Xyte reads each device's state from Shure Cloud on every sync, every 15 minutes.
-
Shure Cloud's device state maps to Xyte like this:
Shure Cloud state Shown in Xyte Online Online Offline Offline Error Error. Xyte opens a Device status changed to error incident, and closes it when Shure Cloud no longer reports the device in Error. Discovered (Shure Cloud is still connecting to the device) Disconnected, not Offline -
Status changes appear in Xyte on the next sync.
-
If a device is removed from Shure Cloud, Xyte doesn't mark it offline. It's removed from Xyte after a while.
How devices are organized
- When you add the connector, you pick a customer and the space to add it to. Xyte creates a connector space named
Shureinside that space, and everything from Shure Cloud is placed under it. - Each Shure Cloud room becomes a space under the connector space, and each device is placed in the space of its room.
- Devices that have no room in Shure Cloud are placed in a space named Unsorted.
- If a space with the same name already exists in the same place, Xyte uses it instead of creating a second one.
Devices also connected through an Edge
If a Shure device is also monitored through a Xyte Edge, it appears twice in Xyte: once from the Edge and once from Shure Cloud. This is expected, as each source adds its own record.
Merge each pair into one device. Both records need to be under the same customer. The merged device keeps the data from both sources, and is counted once. See Merging and splitting devices.
Temporarily unavailableNew Shure connectors can't be added right now while we resolve a rate-limiting issue with Shure Cloud. In the connector catalogue the Shure card shows Coming Soon and can't be selected. Existing Shure connectors stay in place, but may not sync devices until this is resolved. We'll update this page when the connector is available again.
Authorization to ShureCloud is done via API client credentials — a Client ID and Client Secret — generated for an integration that has access to the devices you want to monitor. You create the integration inside ShureCloud, copy its credentials, and paste them into the Shure connector's API Configuration screen in Xyte.
When you add the connector, choose the customer and the space where the Shure devices should appear. Xyte creates the Shure connector space there.
Get your API credentials
Follow these steps in ShureCloud to generate the Client ID and Client Secret, then enter them in Xyte.
Step 1 — Sign in to ShureCloud
Open ShureCloud and sign in with a My Shure ID that can manage API access for your organization. Navigate to the API / Developer integrations area.
Step 2 — Create an integration
Click + Create integration. In the dialog:
- Enter a Name (for example,
Xyte). - Enter a Description (optional, e.g.,
Xyte monitoring). - Tick Agree to the Developer Terms of Service.
- Click Create integration.
Step 3 — Open the integration details
Find your new integration in the list. Click the ⋯ (three-dot) menu on its row and choose View details.
Step 4 — Copy the Client ID and Secret
In the integration details you'll see an App client containing a Client ID and a Secret:
- Copy the Client ID (use the copy icon next to it).
- Click the eye icon to reveal the Secret, then copy it with the copy icon.
Store the Secret now. The Secret may be shown only at this stage. If you lose it, you'll need to reset/regenerate it (which invalidates the old one). If you ever need an additional credential pair, use Add app client.
Step 5 — Enter the credentials in Xyte
Back in the Shure connector's API Configuration screen in Xyte:
- Paste the value into the Client ID field.
- Paste the value into the Client secret field (use the eye icon to verify it pasted correctly).
- Save / connect.
For full API details, see the Shure REST API documentation.
These credentials are stored securely on Xyte servers and are used only to authenticate with ShureCloud on your behalf.
Notes
- Store the Client Secret when it is first shown. Many platforms display the secret only once at creation; if it is lost, you must reset/regenerate it (which invalidates the old secret).
- If 2FA or SSO restrictions are enabled on your ShureCloud account, use a dedicated API integration rather than personal login credentials, or coordinate with your Xyte representative.
Additional information
Connector root space name: Shure
If deleted and re-added:
Deleting this connector will remove all imported devices and their data. This action cannot be undone.
- A new connector will be created upon re-adding.
- If the name
Shurealready exists in that space, the new connector space will be namedShure 2. - The device tree will be re-imported under the new connector.
- The tree hierarchy will not be deleted.
After you submit, you'll see a confirmation that your credentials were submitted. Authorizing the integration and syncing devices can take up to 72 hours — you'll be notified when it's done.
For error messages and what to do about them, see the Shure troubleshooting guide.
Shure Cloud currently limits how many requests Xyte can make. While this is being resolved, an existing connector may fail to authorize or stop importing devices. Your devices and settings are kept. There is no need to delete and re-add the connector (a new Shure connector can't be added right now) — contact [email protected] if you need an update.
Updated 3 days ago
