Skip to main content

Shortcut (previously Clubhouse) Integration

Setup your Shortcut integration effortlessly and get valuable usage insights

M
Written by Marta Droneva
Updated over 2 weeks ago

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

  1. Go to Viio → Integrations and choose Shortcut.

  2. In a new tab, open Shortcut → Settings → API Tokens and click Generate new token.

  3. Copy the token (store it securely—Shortcut shows it only once).

  4. Back in Viio, paste the token into the API Token field.

  5. Click Validate. If the test succeeds, choose Install.

  6. 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 members

    • GET /api/v3/organization – seat and billing info

    • GET /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


Need help? Chat with Viio Support or email [email protected].

Did this answer your question?