# Sentry

Connect Shortcut with Sentry to create Stories from errors, link issues to Stories, and auto-complete when Stories are Done.

## Overview

Sentry is an open-source error tracking tool that helps developers monitor and fix crashes in real time. With this integration, you can:

* Create new Shortcut Stories for bugs and crashes found by Sentry
* Link Sentry Issues to existing Shortcut Stories
* Automatically complete Sentry issues when a linked Shortcut Story is moved to a Done state

## Prerequisites

Before you can set up the Sentry integration, you'll need to have a Sentry account. To create one, [go to their website and follow the steps here](https://sentry.io/signup/).

## Setting Up the Integration

Once your Sentry account is ready:

1. Go to **Settings > Integrations > Sentry** to enable the Sentry integration in Shortcut. Click on the **Sentry account** link to be taken directly to your Sentry account.

![Sentryintegration-notenabled.png](/help/assets/Sentryintegration-notenabled.png)

2. In Sentry, click on **Settings** and then click on **Integrations**. Search for or find the Shortcut integration (look for the blue Shortcut logo) and click on **Install**.

3. You'll be asked to grant access permissions twice: the first screen grants Shortcut permission to access your Sentry Projects, and the second screen grants Sentry permission to access your Shortcut Workspace.

4. If you're comfortable with these permissions, click on **Install** and **Authorize**, respectively.

![Sentry\_Setup.gif](/help/assets/Sentry%20Setup.gif)

## Optional Configuration

After you've granted permission, you'll be taken back to the Sentry integration settings menu in Shortcut, where you can assign:

* A default Shortcut Project
* A default Shortcut Field
* A Requester to each of your Sentry Projects

> Sentry partnered with us in building this integration. [You can find their documentation here](https://docs.sentry.io/product/integrations/issue-tracking/shortcut/).