Prerequisites for All Integrations
Before connecting any integration, ensure:
Admin rights in the target application - Most integrations require an admin or owner-level account in the app you're connecting. A regular user account typically cannot authorize the required API access.
Admin rights in Viio - You need appropriate permissions in Viio to add integrations.
Correct browser session - If you're logged into multiple accounts, use an incognito/private window to avoid session conflicts.
Common Error Messages
"Error authorising your account"
This error appears when the authorisation flow fails.
Common causes: - The account connecting doesn't have admin rights in the target application - Browser session conflict between multiple accounts - The app was previously authorised but permissions were revoked
How to resolve: 1. Confirm you have admin/owner role in the target application's admin console 2. Open Viio in an incognito/private browser window 3. Log into both Viio and the target app with the correct admin account 4. Retry the integration
Example: For GitHub Enterprise, you need the "Enterprise Owner" role—an "Organisation Admin" role is not sufficient.
"Fetch Failed" or "Status: Failed"
The integration connected successfully but cannot retrieve data.
Common causes: - Missing specific API permissions in the target app - The service account lacks required scopes - Temporary API issue on the vendor's side
How to resolve: 1. Check the target app's API documentation for required permissions 2. Ensure the connecting account or service account has all necessary scopes 3. Try disconnecting and reconnecting the integration 4. If the issue persists after 24 hours, contact support
Example: Some HR systems require specific "reports" or "read" permissions that aren't included in a standard admin role.
General Troubleshooting Steps
Verify admin access - Log into the target application and confirm you can access admin/settings areas
Check for permission prompts - During OAuth flows, review what permissions are requested and ensure you approve all required scopes
Use the correct identifier - Some integrations require a specific format (e.g., URL slug vs. display name). Check for spaces or special characters
Wait for sync - After connecting, allow up to 24 hours for the initial data sync
Re-authorise if needed - If permissions changed or were revoked, disconnect and reconnect the integration
Permission Requirements
Viio integrations typically require:
Permission Type | Why It's Needed |
Read users/members | To identify who has access to the application |
Read licenses | To track license assignments and usage |
Read activity/audit logs | To measure application usage |
Write (optional) | Only for lifecycle management features like license revocation |
If you have security concerns about specific permissions, contact [email protected] to discuss read-only options.
Need Help?
If you're still experiencing issues after following these steps, contact [email protected] with:
Screenshot of the error message
Name of the integration you're trying to connect
Confirmation of your admin role in the target application