Connect your Zendesk instance to Viio to see who actually uses seats, track licence consumption, and trim spend—without slowing support teams down.
Capabilities
Capability | What Viio pulls from Zendesk |
✅ Users | Name, email, role, status and last-login time |
✅ Usage | Core activity signals such as ticket updates and audit-log events |
Prerequisites
You must be a Zendesk account admin and a verified user to authorise the app.
Know your Zendesk subdomain (the part before
.zendesk.com
).
Setup
Go to Viio → Integrations and choose Zendesk.
Enter your Zendesk subdomain and click Continue.
Sign in with your Zendesk admin account and review the permission request.
Click Allow. Viio starts the first data sync—this can take up to 15 minutes.
Need to disconnect?
In Viio → Installed apps, find Zendesk and click Remove.
You can also revoke the “Viio” OAuth client in Zendesk → Admin Center → Apps & Integrations → OAuth Clients.
Troubleshooting & FAQ
Symptom | Quick fix |
“Invalid subdomain” error | Double-check you entered only the subdomain (e.g. |
“Permission denied” on connect | Make sure you are logged in as a verified Zendesk admin, then try again. |
Data stopped updating | The OAuth token may have been revoked. Reconnect Zendesk from Viio → Integrations. |
Technical details
Permissions requested
read
&write
on Users – list agents and (optionally) create/disable users for future off-/on-boarding features help.viio.ioread
&write
on Organizations – pull organisation data and audit logs for usage analysis help.viio.io
Primary endpoints called
GET /api/v2/users
– list all users developer.zendesk.comGET /api/v2/organizations
– list organisations developer.zendesk.comGET /api/v2/audit_logs
– fetch account audit events for activity signals developer.zendesk.com
Data refresh runs daily; you can trigger an on-demand sync from Viio at any time.
Additional resources
Zendesk API docs: https://developer.zendesk.com/api-reference/