# YouTrack

> Connect YouTrack so annotated bugs flow from a Testsigma run result into your YouTrack project in one click.

YouTrack integration pushes bugs from a run result straight into a YouTrack project. Screenshots, annotations, and step context travel with the ticket. Connecting takes your account URL and a permanent API token.

## Prerequisites

- Your organization's YouTrack **Account URL** and a YouTrack **API Key** (permanent token).

## Create the API token

1. **Open your profile**: in YouTrack, go to your profile.

2. **Start a token**: go to **Account Security** and click **New Token**.

3. **Create it**: in **New Permanent Token**, enter the **Name** and **Scope**, then click **Create**.

4. **Copy it**: click **Copy Token**.

## Connect YouTrack

1. **Open integrations**: go to **Settings > Integrations**.

2. **Enable YouTrack**: turn on the toggle on the **Youtrack** widget.

3. **Enter the details**: in the **Youtrack Details** dialog, enter the **Organization URL** and **Access Key** (your token), then click **Save & Enable**.

## Report a bug

1. **Open the result**: go to **Run Results** and open the **Test Case Result** where you want to add a bug.

2. **Start the report**: click **Report Bug**.

3. **Pick YouTrack**: in the **Report** overlay, click the **Youtrack** icon.

4. **File it**: review the details and click **Report Bug**.

![The Report panel, with YouTrack picked as the bug tracker](https://s3.amazonaws.com/website-static-docs.testsigma.com/new_images/projects/Updated_Doc_Images/update_youtrack_6.png)

To attach the result to an existing YouTrack issue instead, click the **Link to Issue** tab, search for the issue, and click **Link To Ticket**.

When the bug is created, Testsigma automatically adds test result context to the YouTrack issue, including the test execution video and step screenshots.