Connect your ServiceNow instance to Viio to see who really uses seats, track licence consumption and surface activity trends—so you can optimise spend without slowing IT-service delivery.
Capabilities
Capability | What Viio pulls from ServiceNow |
✅ Users | Full name, corporate email, role, status, last-login date |
Prerequisites
You must be a ServiceNow admin (or use a dedicated service account with the
adminrole).OAuth 2.0 plugin must be active (
com.snc.platform.security.oauth). docs.servicenow.comHave the following ready:
Username & password for the service account
Client ID and Client secret for the OAuth app
Your instance domain (e.g.
acme.service-now.com)
Setup
Go to Viio → Integrations and choose ServiceNow.
In ServiceNow, create an OAuth application:
Navigate to System OAuth → Application Registry.
Click New → Create an OAuth API endpoint for external clients.
Note the Client ID and Client secret—you’ll use them in Viio.
Ensure the system property
com.snc.platform.security.oauth.is.activeis set totrue.Back in Viio, click Connect ServiceNow and enter:
Username & Password
Client ID & Client secret
Instance domain
Click Save. Viio starts the first data sync (usually finishes within 15 minutes).
Need to disconnect?
In Viio, open Installed apps → ServiceNow → Remove.
You can also delete or disable the OAuth app in System OAuth → Application Registry.
Troubleshooting & FAQ
Symptom | Quick fix |
“401 Unauthorised” when connecting | Verify the service-account password and that the OAuth app Redirect URL matches Viio’s callback URL. |
“Invalid client ID / secret” | Regenerate the secret in ServiceNow and update the integration in Viio. |
No usage data | System logs may be disabled or retention set < 30 days. Enable logs or increase retention, then wait for the next daily sync. |
Data stopped updating | The OAuth token expired or was revoked. Re-authorise in Viio → Integrations. |
Technical details
Authentication – Viio exchanges the saved credentials for an OAuth 2.0 access token and sends it in the
Authorization: Bearer <token>header.Primary endpoints called
GET /api/now/table/sys_user– list of all active and inactive users ServiceNowGET /api/now/table/sys_user_role– role assignments per userGET /api/now/table/license_user(or SAM licence tables, when present) – seat type & countsGET /api/now/stats/sys_user_login– aggregated sign-in events
Data cadence – Viio refreshes ServiceNow data daily
Viio respects ServiceNow rate limits and backs off automatically if limits are reached.
Additional resources
ServiceNow – Create OAuth endpoints for external clients documentation
ServiceNow REST API Explorer (in-instance tool)