> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.islo.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.islo.dev/_mcp/server.

# Sentry integration

> Connect Sentry to Islo, triage alerts with Agents, and report results on issues.

Let Agents triage Sentry alerts, read issues and events, and post results back as a comment on the issue.

## Connect in the dashboard

Open [Manage → Integrations](https://app.islo.dev/integrations), select **Sentry** → **Connect**, and approve the **islo.dev** app in your Sentry organization with **Accept & Install**. Return to Islo and confirm the Sentry card shows **Tenant**. The connection is shared across your workspace (tenant scope).

## Connect with the CLI

Sentry connects from the dashboard only.

## Trigger a Line from a Sentry alert

In Sentry, open **Alerts → Create Alert**, select your project, and add both **A new issue is created** and **A resolved issue regresses** under **WHEN**. Under **THEN**, select **Send a notification via islo.dev**. **Do not use “An issue is resolved”**: every resolve would start a run.

In your Islo Line, configure this trigger to pass the Sentry event URL as `input`. Replace `42` with your numeric Sentry project ID. Find the ID in the `?project=` value on the Sentry project Issues URL or under **Project Settings → General**.

```toml
[trigger]
type = "integration_trigger"
provider = "sentry"
name = "event_alert.triggered"

[trigger.selector]
provider = "sentry"
kind = "project"
scope = "selected"
project_ids = ["42"]

[trigger.outputs.input]
type = "trigger_path"
path = "trigger.raw.data.event.web_url"
```

## Use the Sentry API from an Agent

Agents use `Authorization: Bearer $SENTRY_AUTH_TOKEN`; Islo injects the connected credential. Agents can post results back with `POST https://sentry.io/api/0/issues/<issue_id>/comments/` and a JSON body `{"text": "..."}` (the islo.dev app has **Event: Read & Write**). For example (replace `<org>` with your organization slug):

```bash
curl --fail-with-body \
  -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  'https://sentry.io/api/0/organizations/<org>/projects/'
```

The Agent's [gateway profile](/cli/gateways) needs rules for all three Sentry hosts with `provider_key=sentry` and bearer authentication. Replace `<profile>` with its name or ID and add missing rules:

```bash
islo gateway <profile> add-rule \
  --host sentry.io --action allow --provider-key sentry --auth-mode bearer
islo gateway <profile> add-rule \
  --host us.sentry.io --action allow --provider-key sentry --auth-mode bearer
islo gateway <profile> add-rule \
  --host de.sentry.io --action allow --provider-key sentry --auth-mode bearer
```

## Which Suggested Lines need it?

No Sentry Suggested Lines exist yet. Use the alert-triggered Line configuration above.

## Next steps

Follow the [quickstart](/getting-started/quick-start) to create your first factory. Once it exists, [delegate work](/operate/delegations) from a connected tool or [configure an integration trigger](/concepts/triggers) to start work automatically.