# Shortcut

## What is Keeping's Shortcut Integration?

[Shortcut](https://www.shortcut.com/?tum_source=keeping.com) is a project management and issue tracking software that helps teams plan, track, and collaborate on projects. It's designed to streamline software development and improve productivity.

See how Keeping’s Shortcut integration streamlines your support and development workflows. Link a Keeping ticket to a Shortcut story (or create a new Shortcut story) from inside Keeping.

## Shortcut in Keeping

Once connected, you can link a Keeping ticket to a Shortcut story or create a new Shortcut story directly from Keeping.

![Shortcut Linked Issue in Keeping](https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2FNuklb0OsG33cm8d9sjt5%2Fshortcut-linked-story.png?alt=media\&token=b7a321e3-aacf-45b8-8f15-d629449d422e)

## Connecting Shortcut to Keeping

You'll need to be able to be an Shortcut admin to connect it to Keeping.  Start by navigating to the Keeping Integrations page and clicking the **Add Integration** button on the Shortcut tile. From there, you'll need to add your Shortcut API key into the window.

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2F8CBniVxkrpU5hdXnilpK%2Fadd-shortcut-integration.png?alt=media&#x26;token=2966404a-2372-458a-9fbf-8f2b545db295" alt="Asana Keeping Integration"><figcaption><p>Click Add Integration under Integrations --> Shortcut</p></figcaption></figure>

Over in Shortcut, navigate to the **API Tokens** area of your Settings. Name the token, and click **Generate Token.**

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2FEO1virCCTzOIW4zgdhan%2Fshortcut-generate-token-1.png?alt=media&#x26;token=29dd3572-355d-4dc8-9d6c-ead9abe07822" alt=""><figcaption><p>Generate a token in Shortcut</p></figcaption></figure>

Once generated, the token will displayed. Copy the token so you can paste it into the Keeping window in the final step.

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2FVB37GPv8iVGYp0WImqfL%2Fshortcut-generate-token-2.png?alt=media&#x26;token=c9b6963e-50c6-4a60-90ff-6eeca433fa6b" alt=""><figcaption></figcaption></figure>

Finally, paste the token into window and click **Connect**.

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2F6odtF2yfuabhF3WmdhWg%2Flink-shortcut-2.png?alt=media&#x26;token=704c6204-61bd-438b-b543-2409eedeb793" alt=""><figcaption><p>Link Shortcut to Keeping</p></figcaption></figure>

## Search and Link Shortcut Stories from Keeping

Need to link a Keeping ticket to an existing Shortcut story? Search for the issue by Shortcut ID or words in the Shortcut subject or body , and then link it to the Keeping ticket.

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2FpBCLcoqM1uxV7NtDwU2u%2Fshortcut-search.png?alt=media&#x26;token=9fd10ce6-a7b9-477e-9f70-3320855052c0" alt=""><figcaption><p>Search for Shortcut Stories from the Keeping Sidebar</p></figcaption></figure>

## Create New Shortcut Stories from Keeping

You can create new Shortcut stories from the Keeping sidebar. Expand the Shortcut section in the Keeping sidebar, click "Link to Task" and then "Add New" to add a new story to your Shortcut project. The newly created story will be automatically linked to the Keeping ticket.

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2F1XIN81RZk5DN0KDb4a5Y%2Fshortcut-create-story.png?alt=media&#x26;token=59d830fb-6eb2-4dd0-96c1-ce83fad0a784" alt=""><figcaption><p>Create new Shortcut Stories from Keeping</p></figcaption></figure>

## See A Link to Your Keeping Ticket in the Shortcut Story

Once a Shortcut story is connected to a Keeping ticket, Keeping will automatically add a link to the Keeping ticket in the Shortcut.

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2F6LtCT60qU9FubJPK3AUh%2Fshortcut-linked-to-keeping.png?alt=media&#x26;token=da4aac4a-a32e-4b3b-a904-ffd0bbe668d1" alt=""><figcaption><p>See a link to your Keeping ticket in Shortcut.</p></figcaption></figure>

## Unlink a Shortcut Story from A Keeping Ticket

You can unlink a Shortcut story from a Keeping Ticket by clicking the "Unlink" icon next to the Shortcut story subject.&#x20;

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fwy21KHvNA3V1GfZSUDCg%2Fshortcut-unlink-story.png?alt=media&#x26;token=7cb974ab-35d8-41a9-81d1-0e306d5277db" alt=""><figcaption><p>Unlink a Shortcut Story</p></figcaption></figure>
