# Shortcut

## Setup <a href="#setup" id="setup"></a>

Click into the [App Directory](https://app.usepylon.com/apps) from your Pylon dashboard and then click on the Shortcut integration to view setup instructions.

From there:

* Log into Shortcut and generate an API token by going to Settings > API Tokens. Give the token a name and click Generate Token.&#x20;
  * If you're having trouble generating API Tokens, follow [this link](https://help.shortcut.com/hc/en-us/articles/205701199-Shortcut-API-Tokens).
* Copy the API token into the Shortcut configuration modal in Pylon.
* Copy the Webhook URL and Secret Key from Pylon.
* In Shortcut, go to Integrations > Webhooks > Add New Webhook and paste the copied values from Pylon into the Shortcut Webhook.

  * If you're having trouble with Outgoing Webhooks, follow [this link](https://help.shortcut.com/hc/en-us/articles/115005093963-Setting-up-Outgoing-Webhooks).&#x20;

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2FD0aj3oxQMRiKQJAOPIRc%2FCleanShot%202025-09-29%20at%2014.53.56%402x.png?alt=media&#x26;token=bfd03af0-a63d-4d9d-8120-4269bdda76be" alt="" width="563"><figcaption></figcaption></figure>

## Usage <a href="#setup" id="setup"></a>

### Additional App Configuration  <a href="#try-it-out" id="try-it-out"></a>

From the App Directory > Shortcut page, you can choose an Issue Status. This status will automatically be applied whenever an open Shortcut story is linked.

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2FAosHUEDZ3vsxDlMbVLca%2FCleanShot%202025-09-29%20at%2016.38.42.png?alt=media&#x26;token=8fe82da1-fdb2-4ea9-bca1-c202d7b74412" alt=""><figcaption></figcaption></figure>

### Connecting Pylon Issues to Shortcut  <a href="#try-it-out" id="try-it-out"></a>

In the Pylon Issue sidebar, you can search for Shortcut stories to attach. You can:

* Search for and link to an existing story.
* Create a new story.

<figure><img src="broken-reference" alt=""><figcaption></figcaption></figure>

<figure><img src="broken-reference" alt="" width="563"><figcaption></figcaption></figure>

When creating a new story, you can also choose from existing Story Templates in your Shortcut workspace to apply.\ <br>