01
Connect from your Praxa dashboard
In your Praxa workspace, open Connections and choose Sentry. You must be a workspace owner or admin. There is nothing to install on the Sentry side first — the connection starts from Praxa.
Docs · Integrations
Sentry integration.
Connect your Sentry organization and a Praxa AI employee works your error queue like an on-call engineer: it triages new issues as they arrive, investigates alert firings, reads the underlying events to root-cause, and assigns issues to the right owner — with every step recorded in an audit trail you can always check.
Setup
Four steps, no code changes.
The integration is pure OAuth plus webhooks — no SDK changes, no agents to deploy in your infrastructure, nothing added to your error-reporting path.
02
Approve the OAuth consent
You are redirected to Sentry to approve the requested scopes for your organization (listed below — read-mostly, with a single write for issue assignment). Praxa receives a token scoped to the integration itself, never a personal password. The token is encrypted at rest and revocable from either side at any time.
03
Route alerts to Praxa (optional)
New-issue triage works immediately. To also hand alert firings to your agent, edit the Sentry alert rules you care about and add the action "Send a notification via Praxa" — only the rules you choose are routed.
04
Set the guardrails
In Praxa, choose what the agent may do on its own — triage only, or triage + assign — and what should pause for your approval. Limits are enforced in code, not a prompt, and every action lands in the audit trail.
Permissions
Exactly the scopes it needs.
Read-mostly by design. The single write scope exists so the agent can assign an issue to the owner it identified — it cannot resolve, delete, or modify issues beyond assignment, and it cannot touch your projects or settings.
- org:read
- Resolve your organization slug at install time so webhooks route to the right Praxa workspace.
- project:read
- List projects and read project context when investigating an issue.
- event:read
- Read event payloads (message, tags, platform) to root-cause an error, and list issues for triage sweeps.
- issue:read
- Read issue metadata — level, status, counts, first/last seen — for triage decisions.
- issue:write
- Assign an issue to a user or team once the agent has identified the right owner. The only write the integration performs.
Webhooks
What triggers a run.
Praxa verifies the signature on every delivery (Sentry-Hook-Signature, HMAC-SHA-256) before anything runs. Unsigned or unrecognized deliveries are acknowledged and dropped.
- issue → created
- Starts a triage run: the agent reads the new issue and its latest event, assesses severity and likely cause, and assigns or escalates per the rules you set.
- issue alerts (event_alert)
- Fires when an issue alert rule with the "Send a notification via Praxa" action matches. The agent investigates the alerting issue in context.
- metric alerts (metric_alert)
- Fires on metric-alert threshold crossings routed to Praxa. The agent investigates the alert and summarizes what changed.
Data handling
What Praxa stores, and what it doesn't.
- TokensThe integration token is encrypted at rest, scoped to your workspace, and revocable in one click from Praxa — or by removing the integration in Sentry, which is always the source of truth.
- Issue and event dataRead on demand during a run to make a triage decision. What the agent saw, decided, and did is kept in your workspace's audit trail (90 days as standard); Praxa does not build a copy of your Sentry data outside of that record.
- UninstallingRemove the integration in either Praxa (Connections → Sentry → disconnect) or Sentry's own settings. Webhook deliveries stop routing immediately and the stored token is discarded.
Changelog
Changes to this integration.
Modifications to the published integration are recorded here.
- 2026-07-08
- Initial public release: OAuth install, issue-created triage, issue-alert and metric-alert investigation, issue assignment, signed-webhook verification.
Questions or problems? Email support@praxa.run.
Get started
Put an AI employee on your error queue.
Connect Sentry in a couple of minutes and watch the first triage happen on your next new issue.