Skip to main content

Sentry Integration

Setup Sentry integration effortlessly and get valuable usage insights

M
Written by Marta Droneva
Updated over 2 weeks ago

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

  1. Go to Viio → Integrations and choose Sentry.

  2. In Sentry, generate an Auth Token:

    1. Open Settings → Developer Settings → API Keys.

    2. Click Create New Token.

    3. Tick org:read (and member:admin if you want off-boarding) and press Create Token.

    4. Copy the token.

  3. Back in Viio, click Connect Sentry, paste the token, then click Save.

  4. 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 Docs

    • GET /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

Did this answer your question?