Connect Viio with your Atlassian organisation to pull user, group and product‑usage data into Viio’s SaaS Intelligence dashboard. The one‑way sync is read‑only and takes just a few minutes to set up.
Capabilities
Capability | What it means in Viio |
✅Users | See every active Atlassian user account so you can spot unused licences. |
✅Groups | Understand team membership and permission scopes. |
✅Products | Track which Atlassian cloud products (Jira, Confluence, Bitbucket, etc.) are in use. |
✅Usage | View last‑active date and basic activity metrics for cost‑optimisation. |
✅Licences | Compare purchased seats with real‑world usage. |
Prerequisites
Before you start you need:
Administrator rights in your Atlassian organisation (org‑level admin, not just site admin).
The ability to create an API key (see below).
Be on managed domains in Atlassian - to check visit this article
Create an Atlassian API key
Sign in at Atlassian Admin.
Click the Organisation name (top‑left).
Select Settings.
In the left‑hand menu choose API keys.
Click Create API key.
Enter a descriptive label — for example “Viio Integration”.
Set an expiration date (Viio recommends one year).
Click Create and immediately copy the generated key. You will not be able to see it again.
Setup
Open Viio → Integrations and choose Atlassian.
Paste the Key you copies in the previous tutorial
Include your Atlassian domain, it should be in the following format: https://your-domain.atlassian.net
Choose if you have Atlassian Guard enabled or not - if you do not know this you can skip defining it and change on a later stage
Setting up other Atlassian product API keys such as Jira or Trello can be done on a later stage.
Troubleshooting & FAQ
Issue | Quick fix |
“Invalid API key” error | Check that the key was pasted without spaces and has not expired. Generate a new key if needed. |
No data after 30 minutes | Confirm the Atlassian admin account still has org‑level access and that the integration shows “Connected” in Viio. |
Need higher‑frequency syncs | Viio refreshes Atlassian data nightly. Contact Viio Support if you require a different cadence. |
Technical details
Auth method: Atlassian REST API + API key (HTTP header
Authorization: Bearer <token>)Permissions requested:
Read users (
/users,/groups)Read product usage data (
/usage,/subscriptions)
Data flow: One‑way, read‑only from Atlassian → Viio. No data is written back.