Connect your Shortcut workspace to Viio and get clear insight into users, real activity, and licence usage—so you never overpay.
Capabilities
Capability | What it means in Viio |
✅ Users | Syncs every active Shortcut member so you can map ownership and cost. |
✅ Usage | Pulls the Last activity timestamp (based on story updates) to flag dormant users. |
Prerequisites
You must be a Workspace Admin in Shortcut.
Generate a Shortcut API token (Admin → Settings → API Tokens).
If your organisation blocks external apps, whitelist
https://app.viio.io
.
Setup
Go to Viio → Integrations and choose Shortcut.
In a new tab, open Shortcut → Settings → API Tokens and click Generate new token.
Copy the token (store it securely—Shortcut shows it only once).
Back in Viio, paste the token into the API Token field.
Click Validate. If the test succeeds, choose Install.
Wait a few minutes while Viio completes the first sync. Progress appears in the integration tile.
Troubleshooting & FAQ
Issue | How to resolve |
“Invalid token” error | Ensure you copied the token correctly—no extra spaces—and that the user who created it is still an Admin. |
No data after first sync | Check that the token is still listed under Settings → API Tokens and has not been revoked. |
Seats don’t match Shortcut billing UI | Shortcut counts every active member; Viio ignores disabled users. Re‑enable or delete duplicates to align numbers. |
User activity looks outdated | Viio bases activity on story updates. If your team uses Git integrations only, activity may appear lower than expected. |
Technical Details
Auth method: Personal API Token (inherited admin scopes).
Key endpoints called (Shortcut REST API v3):
GET /api/v3/members
– fetch membersGET /api/v3/organization
– seat and billing infoGET /api/v3/stories?updated_after={timestamp}
– pull activity for last‑seen calculation
Viio is read‑only; it never creates, edits, or deletes data in Shortcut.
Data refresh cadence: every 24 hours
Additional resources
Shortcut API reference – https://shortcut.com/api/rest/v3
Viio security statement – https://www.viio.io/security
Need help? Chat with Viio Support or email [email protected].