IntegrationsSentry
OAuth Integration Setup
Connect multiple Sentry organizations to BlameTrail using the OAuth integration with automatic token refresh.
The OAuth integration mode is designed for teams that prefer OAuth-based authentication. Users authorize via an OAuth flow, and BlameTrail manages token refresh automatically. Multiple organizations can connect their own Sentry organizations independently.
Prerequisites
- A Sentry account with permissions to authorize integrations
- A BlameTrail organization with admin access
Step 1: Connect via OAuth
- In BlameTrail, navigate to Organization > Integrations.
- In the Sentry section, click Connect via OAuth.
- BlameTrail redirects to Sentry's authorization page.
- Select which Sentry organization to connect and click Authorize.
- Sentry redirects back to BlameTrail with an authorization code.
- BlameTrail exchanges the code for an access token and refresh token.
The integration status changes to Connected and displays the connected Sentry organization.
Step 2: Set up project mappings
After connecting, map Sentry projects to BlameTrail services so webhooks create incidents on the correct service. See Project Mappings.
Token refresh
OAuth tokens issued by Sentry expire periodically. BlameTrail handles this automatically:
- A background job monitors token expiration and refreshes tokens before they expire.
- If a refresh fails, BlameTrail retries with exponential backoff.
- If repeated refresh attempts fail, the integration status changes to Disconnected and an admin must reconnect via OAuth.
No manual intervention is required under normal operation.
Differences from internal integration
| Feature | Internal | OAuth (Public) |
|---|---|---|
| Setup complexity | Lower | Higher (requires Sentry authorization flow) |
| Token management | Manual, does not expire | Automatic refresh |
| Multi-org support | Single org per integration | Multiple orgs can connect independently |
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| OAuth redirect fails | Browser or network issue | Try again, ensure pop-ups are not blocked |
| Token refresh fails repeatedly | Sentry integration was removed or permissions changed | Reconnect via Organization > Integrations > Sentry > Reconnect |
| Integration shows disconnected | Token refresh failed permanently | User must reconnect via Organization > Integrations > Sentry > Reconnect |