Capabilities
Capability | What it means in Viio |
✅ Users | We fetch all users in your desk.ly organisation, including their name, email, role, and active status |
✅ Usage | Resource booking activity per user, showing when each person last booked a desk or other workspace resource |
✅ Plans & Licenses | All desk.ly users are tracked under a single plan, reflecting your organisation's subscription |
Prerequisites
You must be on the Enterprise Plus package in desk.ly — the API is only available on this plan
You need administrator access to your desk.ly organisation to generate an API key
Setup
Generate an API key in desk.ly:
Log in to your desk.ly account at https://app.desk.ly
Navigate to your organisation's admin settings
Locate the API section and generate a new API key
Copy the key — you will need it in the next step
Configure the integration in Viio:
Open Viio and go to Integrations
Find desk.ly and click Connect
Paste your API key when prompted
Click Continue, add a name for the connection, and click Save
Initial sync:
Viio will fetch your current desk.ly users and begin tracking resource booking activity
Usage data is synced incrementally, so each subsequent sync picks up new bookings since the last run
Troubleshooting & FAQ
Issue | Quick fix |
I'm getting an authentication error during setup | This means the API key was entered incorrectly or is no longer valid. Return to your desk.ly admin settings, generate a new API key, and re-enter it in Viio. Confirm your organisation is on the Enterprise Plus plan, as the API is not available on lower-tier plans. |
Why can't I see any users? | Make sure your API key has been generated with the correct permissions and belongs to an administrator account. If the key is valid but users are still missing, check that your desk.ly organisation has active users configured. |
What does usage data represent? | Usage reflects resource bookings made by each user — for example, booking a desk, meeting room, or other workspace resource. The last activity date shown for a user corresponds to the start time of their most recent booking. |
Why is a user showing as inactive? | Users are marked inactive when desk.ly reports them as deactivated in your organisation. Only active users are counted for billing purposes in Viio. |
How are users counted for billing in Viio? | All users returned by desk.ly are considered billable and are assigned to your organisation's default plan. There is no partial billing based on role or activity level. |
I don't see the API option in my desk.ly admin settings. | API access is exclusive to the Enterprise Plus package. If you do not see the API section, your current plan does not include this feature. Contact desk.ly support or your account manager to upgrade. |