Connect your Sentry organisation to Viio to get a clear view of active users, seat consumption and real-world activity—so you can right-size spend without slowing engineering teams down.
Capabilities
Capability | What Viio pulls from Sentry |
✅ Users | Name, email, status (active / pending / disabled) and role |
✅ Usage | Last event timestamp per user and monthly sign-in counts (from audit logs) |
Prerequisites
You must be an Organisation Owner (or another role that can create auth tokens) in Sentry.
Create an Auth Token with at least the following scopes:
org:read
– read users and activity
Copy the token value—you will paste it in Viio. Sentry shows it only once.
Setup
Go to Viio → Integrations and choose Sentry.
In Sentry, generate an Auth Token:
Open Settings → Developer Settings → API Keys.
Click Create New Token.
Tick org:read (and member:admin if you want off-boarding) and press Create Token.
Copy the token.
Back in Viio, click Connect Sentry, paste the token, then click Save.
Viio starts the first data sync—this usually finishes within 15 minutes.
Need to disconnect?
In Viio, open Installed apps → Sentry → Remove.
Or revoke the token in Sentry → Settings → Developer Settings → API Keys.
Troubleshooting & FAQ
Symptom | Quick fix |
“Invalid token” on connect | The token was copied incorrectly or later revoked. Create a new token and reconnect. |
No users listed | The token must have the org:read scope and belong to a user who can see All Members. |
Data stopped updating | Tokens are immediately invalid after revocation or permission changes. Re-create the token and reconnect Sentry. |
Technical details
Authentication – Viio sends
Authorization: Bearer <token>
on every call.Primary endpoints called
GET /api/0/organizations/{org_slug}/members/
– organisation members and roles Sentry DocsGET /api/0/organizations/{org_slug}/users/
– user activity timestamps (audit events)
Data cadence – Viio refreshes Sentry data daily
Viio respects Sentry rate limits (60 requests/min per token); we back off automatically if limits are hit. Sentry Docs
Additional resources
Sentry API reference: https://docs.sentry.io/api/