---
sidebar_position: 6
title: Sentry Integration
---

# Sentry Integration

Connect a Sentry organization so your agents can list projects, list issues, and fetch issue detail — read-only. Sentry uses **OAuth 2.0 with PKCE**.

## How It Works

You authorize Zibby against your Sentry organization via OAuth (PKCE — no client secret). Once connected, the `sentry` skill exposes read-only Sentry tools to any node that declares it. This powers the [Sentry triage](../recipes/sentry-triage.md) agent.

## Connect Sentry

1. In the Zibby dashboard, go to **Settings → Integrations** and click **Connect Sentry**
2. You're redirected to Sentry to authorize Zibby
3. Pick the organization to grant access to
4. You're redirected back to Zibby

## What Agents Can Do

Nodes that attach the [`sentry` skill](../skills/sentry.md) get read-only tools:

| Tool | What it does |
|---|---|
| `sentry_list_projects` | List projects in the connected organization |
| `sentry_list_issues` | List issues (supports Sentry search syntax, sort, limit) |
| `sentry_get_issue` | Detailed info for one issue by ID |

Access is read-only by design — the triage agent reads issues and routes them via Slack/Lark rather than mutating Sentry.

## See also

- [Sentry skill reference](../skills/sentry.md) — full tool surface
- [Sentry triage recipe](../recipes/sentry-triage.md) — the agent that consumes this connector

## Troubleshooting

**"Reconnect Sentry"** — the OAuth grant was revoked or expired. Go to Settings → Integrations and reconnect.

**No issues returned** — check the project filter and that the org you authorized actually owns the project.
