Skip to main content

Asana Integration

Setup Asana Integration in seconds

M
Written by Marta Droneva
Updated over 2 weeks ago

Connect your Asana workspace to Viio to see who’s really using seats, track activity, and trim licence costs—without slowing anyone down.


Capabilities

Capability

What Viio pulls from Asana

✅ Users

Name, email, status (active/disabled), admin flag

✅ Licences

Seat type (member vs guest)


Prerequisites

  • You must be an Asana workspace or organisation admin to create the token.

  • Generate a Personal Access Token (PAT) in Asana and copy it—you’ll paste it in Viio.


Setup

  1. Go to Viio → Integrations and choose Asana.

  2. Create a PAT in Asana:

    1. Click your avatar → Developer App Management.

    2. Open Personal access tokens+ New token.

    3. Give the token a name (e.g. “Viio-integration”) and click Create.

    4. Copy the token—you won’t see it again.

  3. Back in Viio, click Connect Asana, paste the token and hit Save.

  4. Viio starts the first data sync (usually finishes within 15 minutes).

Need to disconnect?
In Viio, open Installed apps → Asana → Remove.
You can also revoke the PAT in Asana under Developer App Management → Personal access tokens.


Troubleshooting & FAQ

Symptom

Quick fix

“Invalid token” on connect

The PAT was copied incorrectly or later revoked. Create a new token and reconnect.

No users appear

The admin who generated the token must still belong to the workspace and have access to All members.

Data stopped updating

PATs become invalid after regeneration or role changes. Re-create the token and reconnect Asana.


Technical details

  • Authentication – Viio sends Authorization: Bearer <TOKEN> with every call. developers.asana.com

  • Primary endpoints called

    • GET /workspaces/{workspace_gid}/users – full user roster developers.asana.com

    • GET /events on workspaces & projects – recent activity for usage metrics developers.asana.com

    • GET /workspaces/{workspace_gid} – workspace plan & seat counts

  • Data cadence – Viio refreshes Asana data daily

  • Viio respects Asana rate limits and backs off automatically if thresholds are hit.


Additional resources

Did this answer your question?