Skip to main content

Autodesk Integration Configuration

How to set up Autodesk Integration

M
Written by Marta Droneva
Updated over a week ago

Connect your Autodesk Construction Cloud (ACC) or BIM 360 account to Viio to track seats, real usage, and project activity—so you only pay for licences you need.

Capabilities

Capability

What it means in Viio

Users

Imports every active ACC / BIM 360 user so you can map ownership and cost.

Usage

Captures each user’s last project activity date (via Premium Reporting) to flag dormant accounts.

Plans & Licences

Fetches seat allocations and compares them with seats actually used.

Prerequisites

  • ACC / BIM 360 Account Admin role.

  • Your BIM 360 Account ID (find it in Account Admin → Settings).

  • An Autodesk Personal Access Token (PAT) with Premium Reporting scope.
    Create one via Autodesk Platform Services; follow Autodesk’s guide: https://aps.autodesk.com/blog/understanding-pat-its-benefits-and-how-obtain-pat.

  • Ability to authorise the Viio app when prompted. The app requests access to:

    • Data Management API

    • Premium Reporting API

    • Autodesk Construction Cloud API

    • BIM 360 API

Setup

  1. Go to Viio → Integrations and choose Autodesk BIM 360 / ACC.

  2. Enter your BIM 360 Account ID.

  3. Paste the PAT you generated (must include the premium_reporting scope).

  4. Click Validate. Viio verifies the token and account.

  5. When prompted, sign in to Autodesk and Authorise the Viio application. Review the four API scopes listed above and accept.

  6. Back in Viio, give the connection a friendly name (e.g. EMEA ACC), then click Install.

  7. Viio begins the first sync.

Troubleshooting & FAQ

Issue

How to resolve

“Invalid token or scope”

Ensure the PAT is active, includes premium_reporting scope, and has not expired.

Authorisation window loops

Pop‑up blockers can interfere—allow pop‑ups for app.viio.io and retry.

No data after 24 h

Confirm the PAT is still valid and that Premium Reporting is enabled in your Autodesk plan.

Seats don’t match Autodesk billing portal

Autodesk counts all users; Viio ignores users set to Inactive in Account Admin. Reactivate or remove duplicates.

User activity looks outdated

Premium Reporting events take up to 24 h to appear. Check back later or verify that reporting is enabled for the account.

Technical Details

  • Auth method: Personal Access Token (PAT) + OAuth app grant.

  • Key endpoints called:

    • GET /hq/v1/accounts/{account_id}/users – fetch users

    • GET /analytics/v2/usage/users?account_id={account_id}&from={date} – Premium Reporting (last‑activity)

    • GET /hq/v1/accounts/{account_id}/licenses – seat data

    • GET /project/v1/hubs/{hub_id}/projects – project metadata (future features)

  • Viio operates read‑only; it never creates, edits, or deletes Autodesk data.

  • Data refresh cadence: every 24 hours

Additional resources


Need more help? Contact Viio Support via in‑app chat or email [email protected].

Did this answer your question?