# Connect Sentry to a Shipfox workspace (https://www.shipfox.io/docs/integrations/sentry/setup)

Description: Install the Sentry App, choose an organization, and verify issue delivery with a workflow run.

Connect Sentry when a new issue should start a Shipfox workflow. See the
[Sentry overview](https://www.shipfox.io/docs/integrations/sentry) for its capabilities.

## Before you begin [#before-you-begin]

You need access to workspace integration settings. You must also be able to
install an App in the target Sentry organization.

To verify a run, you also need a project that can sync workflows and an online
runner with the `shipfox` label.

## Install the Sentry App [#install-the-sentry-app]

### Start the integration connection

Open **Settings → Integrations** in the workspace. Select **Sentry**, then
start the integration connection. Shipfox opens the Sentry App installation flow.

### Authorize the organization

Select the Sentry organization and authorize the App. Sentry returns you to
Shipfox, which verifies the installation.

### Record the integration connection slug

Open the new integration connection's menu. Select **Use this integration**. Copy the
slug from the trigger example. Workflows use that value as `source`.

## Add a test workflow [#add-a-test-workflow]

Create `.shipfox/workflows/check-sentry-connection.yml`. Replace `sentry_acme`
with the integration connection slug. This is a complete workflow:

```yaml
# yaml-language-server: $schema=https://www.shipfox.io/docs/workflow.schema.json
name: Check the Sentry integration connection
runner: shipfox

triggers:
  on_issue:
    source: sentry_acme # Replace with the slug of your Sentry integration connection.
    event: issue.created

jobs:
  check:
    steps:
      - env:
          ISSUE_ID: "${{ event.issueId }}"
          ISSUE_TITLE: "${{ event.title }}"
        run: |
          printf 'Received Sentry issue %s: %s\n' "$ISSUE_ID" "$ISSUE_TITLE"
```

Commit and push the workflow to the project's default branch. Wait for **Check
the Sentry integration connection** to sync.

## Verify the integration connection [#verify-the-integration-connection]

Make sure the integration connection is enabled in **Settings → Integrations**. Select
**View recent events**. Create a safe test issue in Sentry.

Open the new issue event and its linked run. Confirm that the log prints the
same issue ID and title. This proves the App delivered the issue and the trigger
used the saved integration connection slug.

The [Sentry events reference](https://www.shipfox.io/docs/integrations/sentry/events) lists event names and
normalized event fields. The [Sentry triage recipe](https://www.shipfox.io/docs/how-to/recipes/triage-sentry-issues)
turns a delivered issue into an agent run.