# 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="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-9ef6456a8b561414059c1d95e6bd778816c54550%2FCleanShot%202024-05-24%20at%2009.54.03%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

2\. From the incident details page

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-5b9ddcdf35248da029ee3fcce6e495bbdc8eb2bb%2FCleanShot%202024-05-24%20at%2009.59.16%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-6bc9d1d5dbfdbda87aa2c61210a60473a52145ea%2FCleanShot%202024-05-24%20at%2009.54.46%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-b94def9ae490f55925dfe85bd404c3ae7e45ddbd%2FCleanShot%202024-05-24%20at%2009.56.52%402x.png?alt=media" 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="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-03eb166048abeb83e0b32ec022bbbaae6f03811c%2FCleanShot%202024-05-24%20at%2010.20.54%402x.png?alt=media" 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="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-f86fd7beb9d94441c0bc6a17113750da658f6113%2FCleanShot%202024-05-24%20at%2010.24.32.gif?alt=media" 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 %}