# 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>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.usepylon.com/pylon-docs/integrations/ticketing/shortcut.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.