About Logitech Sync
Logitech Sync is Logitech’s service for managing video conferencing devices, such as Rally systems, across your meeting rooms and desks. Admins work in Sync Portal. This integration connects Serval to one Sync organization through the Sync Cloud API, so workflows can look up rooms, desks, and devices with their status, and act on them.api.sync.logitech.com, and requests carry no token or API key. Serval stores the certificate and key encrypted and uses them only for connections to api.sync.logitech.com, so workflows never handle them.
Data sync: No background sync starts when you connect, and there are no installable ingestion workflows. Data access is on demand through workflows.
What the Logitech Sync integration enables
Get your credentials
Serval needs three values from Sync Portal: a certificate, its private key, and your Organization ID.Open the Sync Cloud API settings
Generate a certificate
certificate.pem) and a private key (privateKey.pem). Download both files and store the private key securely, never in plain text or in a code repository.Copy your Organization ID
Check the API server
api.sync.logitech.com. That’s the server Serval connects to.POST, PUT, PATCH, and DELETE requests that reboot devices, start software updates, change device settings, or delete rooms and devices. What the certificate may do in Sync is the only limit, so protect it like an admin credential.Connect in Serval
Open the Logitech Sync connect form
Enter the Organization ID
Paste the certificate
certificate.pem, including the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- lines.Paste the private key
privateKey.pem, including its BEGIN and END lines. The key is shown masked after saving.Save, then check the health check
Verifying the connection
The connection ships one health check that makes a live call to Logitech Sync:- List Logitech Sync Places: reads one licensed room or desk. When it passes, Sync accepted the certificate for your Organization ID and the organization’s license lets it use the API. On success the message reads “Successfully reached Logitech Sync (places visible: 1).”
places visible: 0 means the connection works but Sync returned no licensed room or desk.
When the check fails, its message starts “Unable to reach Logitech Sync” and the error details show the HTTP status that Sync returned. The sections below explain the common ones.
Gotchas and troubleshooting
The health check fails with HTTP 403
The health check fails with HTTP 403
The health check fails with HTTP 402 and NOT_ENTITLED
The health check fails with HTTP 402 and NOT_ENTITLED
Saving fails because the certificate and private key don't match
Saving fails because the certificate and private key don't match
Serval connects only to api.sync.logitech.com
Serval connects only to api.sync.logitech.com
api.sync.logitech.com. If Sync Portal lists a different API server for your organization, contact support before you connect.Rooms, desks, or IDs are missing from place results
Rooms, desks, or IDs are missing from place results
GET /place returns licensed rooms and desks only. Pass unlicensed=true to include unlicensed ones. Their devices come back without status. The endpoint also requires shortIds: send true to get the 32-character room, desk, and device IDs that the other Sync Cloud API endpoints accept.Logitech limits the request rate
Logitech limits the request rate
POST /bulk runs up to 200 requests in one call and counts as a single request. It doesn’t accept list requests, device reboots, or device updates, and it returns HTTP 200 even when some items fail, so check the status of each item in the result. projection on GET /place limits the response to the fields you need.Reboots and software updates finish later
Reboots and software updates finish later
updateStatus is UpdateAvailable, and a successful response means the request was sent. Track progress with the device’s updateStatus.Connecting more than one Sync organization
Connecting more than one Sync organization
Need help? Contact support@serval.com for assistance with your Logitech Sync integration.

