> For the complete documentation index, see [llms.txt](https://docs.snyk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snyk.io/scan-fix-and-prevent/scan-with-snyk/snyk-api-web/integrations/issue-tracking/integrate-with-shortcut.md).

# Integrate with Shortcut

How to integrate Snyk API & Web with Shortcut

{% hint style="info" %}
**Snyk is rolling out a new navigation.** The steps on this page describe the classic interface. If your view looks different, visit [Navigate the Snyk Web UI](https://docs.snyk.io/navigate-the-snyk-web-ui#where-things-moved) to map these options to the new interface.
{% endhint %}

## Integrate with Shortcut

You can synchronize findings with your Shortcut storyboard by connecting Snyk API & Web to Shortcut. Snyk can do this synchronization automatically or manually, finding by finding.

Synchronization is one-way. Snyk does not propagate changes made to Shortcut items to their respective findings in Snyk. Snyk also does not sync manual changes to Snyk findings to Shortcut. Snyk syncs only changes caused by a scan.

### Generate a Shortcut token

1. In Shortcut, navigate to **Your Account > Settings > API Tokens**.
2. Name and generate a new token.
3. Copy and save the token somewhere secure. When you generate a new token, the value appears only once, so write it down.

### Authenticate and configure the integration

After you have the token, use it to authenticate with Snyk.

1. Log in to your account and choose **Integrations** from the side menu.
2. Scroll to the Shortcut option.
3. Enter your token and click **Save**.
4. Next, navigate to your target's **Settings** and access the **Integrations** tab to set up the configuration.
5. Fill out the required fields in the Shortcut configuration form. It includes:
   * **Project**
   * **Story type**
   * **Priority mapping**
   * **Severity mapping**

Snyk requires this information to start synchronizing findings.

1. Select the **Automatically sync all findings** box. Otherwise, Snyk does not start synchronizing them.

If you do not want to synchronize all the findings, or if you prefer to hand-pick some of them, you can manually configure the synchronization for certain findings instead of selecting this box. To do that:

1. Navigate to that target and choose a finding you want to synchronize with your Shortcut project and board.
2. Select the **Sync finding** box to get updates from Snyk to Shortcut.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snyk.io/scan-fix-and-prevent/scan-with-snyk/snyk-api-web/integrations/issue-tracking/integrate-with-shortcut.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.