Capabilities
✅ Users | We fetch all users who are members of your OpenAI organization, including their email addresses, assigned roles, and account status |
✅ Plans & Licenses | Seat type (member vs guest) |
✅ Usage | We monitor API usage patterns over the last 60 days, tracking the last activity date and model requests for each user |
Prerequisites
You must be an Organization Owner in your OpenAI organization. Regular members, admins, or billing users cannot configure this integration
You must have access to platform.openai.com to generate API credentials
You'll need to generate an Admin API Key (not a regular project API key)
Setup
Get your OpenAI Admin API key:
Log in to platform.openai.com
Navigate to Settings > Organization settings
Select Admin keys from the left navigation menu
Click Create new secret key
Important: Choose "Admin" from the key type dropdown — only admin keys provide organization-level access. Regular project keys will not work.
Copy the key immediately and store it securely — you won't be able to view it again
You may also optionally set an expiration date for the key
Configure the integration in Viio:
Open Viio and navigate to Integrations
Select OpenAI and click Connect
Enter your Admin API Key when prompted
Click Continue, give the integration a name (e.g., "OpenAI Organization"), and click Save
Initial sync:
Viio will immediately retrieve your organization's users and current API usage data
The integration will continue to sync automatically to keep your data up to date
You can view your connected users and usage insights in the Viio dashboard
Troubleshooting & FAQ
Symptom | Quick fix |
I'm getting an authentication error after entering my API key | Ensure you're using an Admin API Key, not a regular project API key. Admin keys are generated under Settings > Organization settings > Admin keys. Regular API keys won't work with this integration. |
I don't have permission to generate an API key | Only Organization Owners can create Admin API keys. If you're an admin or member, ask an Organization Owner to generate the key for you and provide it to Viio. |
Why aren't all my organization members showing up? | Viio only displays users who are currently active members of your OpenAI organization. Users who have been removed or have pending invitations won't appear. |
What does "usage" measure? | Usage tracks API requests (model completions) made by each user over the last 60 days. The last activity date shows when each user most recently used OpenAI's API. Users with no API activity in the past 60 days won't appear in usage data. |
Can I use a project-level API key instead of an admin key? | No. This integration requires an Organization Admin API Key to access organization-level user and usage data. Project-level API keys only provide access to a specific project and cannot retrieve the data Viio needs. |
How often does Viio sync my OpenAI data? | Viio automatically syncs your data on a regular schedule. Each sync retrieves current user information and the last 60 days of usage data. |
What happens to my data if I revoke the API key? | If you revoke or delete the Admin API Key, Viio will no longer be able to fetch new data from OpenAI. Your previously synced data will remain in Viio, but it won't be updated. To resume syncing, generate a new Admin API Key and update the integration settings. |
Will deleted users still appear in the usage data? | Once a user is removed from your OpenAI organization, they won't appear in future syncs. However, their historical usage data from the last 60 days may still be visible until the next complete sync cycle. |