# Shortcut

### How to setup Shortcut?

To connect [Shortcut](https://shortcut.com), head to [Settings > Organisation](https://app.spike.sh/settings/general/organisation) and find the Task management integrations section. The connect will ask you for your Shortcut API key. Once saved, Spike will validate the token to safely authenticate and create stories.

{% hint style="info" %}
Spike does not read any of your data from Shortcut.
{% endhint %}

### How to create a story on Shortcut from Spike?

There are 2 ways

1. From the dashboard

<figure><img src="/files/TF4VkfEDMzeUJjiGL5Qf" alt=""><figcaption></figcaption></figure>

2\. From the incident details page

<figure><img src="/files/oSNFl1BAGtCA2mQagAqC" alt=""><figcaption></figcaption></figure>

You can pre-configure your story before sending to Shortcut.

<figure><img src="/files/fgjZa14di3gdYczlrinN" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/MZNotzur5sCRNz5j3Rss" alt=""><figcaption><p>Create multiple stories with multiple incidents.</p></figcaption></figure>

### Automating with Playbooks

You can automate creating stories on Shortcut with Playbooks. The example below would create a Shortcut story for every new incident with Error in title on our Notification service.

<figure><img src="/files/6Rvku3ByGY7M0iTP4QUT" alt=""><figcaption><p>Automate Shortcut stories with Playbooks</p></figcaption></figure>

The Playbook will also be available for members with permissions to run

<figure><img src="/files/tog86SyX6iUJahOcAvEV" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Once setup, every member across every team from your account will have access to create stories on Shortcut from Spike
{% endhint %}


---

# 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.spike.sh/collaboration/task-management-integrations/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.