Capabilities
Users | All user accounts in your TestRail organisation, including their name, email, role, and active/inactive status |
Licenses | License assignment data for all active users, enabling you to track who is consuming a seat |
Plans | A default plan representing your TestRail subscription, used to group license data |
Prerequisites
To set up the integration, you’ll need:
Administrator access to your TestRail instance
TestRail plan that supports API access (Cloud and Server both support it)
Your TestRail instance URL (e.g. https://yourcompany.testrail.io)
An API key generated from an administrator account
Setup
Generate a TestRail API key:
Log in as an administrator
Click your avatar > My Settings
Scroll to API Keys > Add Key > Generate Key
Copy the generated API key
Configure in Viio:
Navigate to Integrations > TestRail > Connect
Enter your TestRail instance URL, email, and API key
Click Continue, add a name, and Save
Initial sync begins automatically and runs on a regular schedule.
Troubleshooting & FAQ
Issue | How to resolve |
Authentication error | Verify email matches the API key owner, no extra spaces in the key |
Inactive users | Reflects TestRail status directly; inactive users don't consume a license seat |
Missing users | Verify they exist in TestRail and your admin account can view all users via API |
Base URL format | Use root URL (e.g. https://yourcompany.testrail.io), no trailing slash |