---
description: >-
  Shortcut integrations helps you create stories from incidents with all it's
  details
---

# 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.&#x20;
{% 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%2FBYDgaCrzlr84tYf8W7HL%2FCleanShot%202024-05-24%20at%2009.54.03%402x.png?alt=media&#x26;token=522145d2-d361-4699-9de8-f49f784787df" 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%2FoINCXWPKcFnvOx1iyQ60%2FCleanShot%202024-05-24%20at%2009.59.16%402x.png?alt=media&#x26;token=a4756f90-1746-4322-8e6d-b1dfc8ccc47f" alt=""><figcaption></figcaption></figure>

You can pre-configure your story before sending to Shortcut.&#x20;

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2FTSk1ndFRjbTMRPjmFeBE%2FCleanShot%202024-05-24%20at%2009.54.46%402x.png?alt=media&#x26;token=eb63004f-5660-4ae7-b98c-46be1315c77f" 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%2FaLFUgbJexWI0Ubp8oRx8%2FCleanShot%202024-05-24%20at%2009.56.52%402x.png?alt=media&#x26;token=7e6078e5-01ad-4817-94c5-9586e066b4f6" 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%2FB02LSjxr2VM4cpoysqRK%2FCleanShot%202024-05-24%20at%2010.20.54%402x.png?alt=media&#x26;token=7c07a4c1-a776-4c23-8044-71d04bbe57d7" 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%2FdPDCdrKs0y3qn6fB9ANO%2FCleanShot%202024-05-24%20at%2010.24.32.gif?alt=media&#x26;token=b2e3b45e-c6b6-432b-83e4-286ebd418a77" 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 %}
