Shortcut - User Guide

In this article, you will understand step by step how to easily integrate with Shortcut

Integrating with Shortcut will streamline the auditing of the change management process and ensure an accurate and complete list of changes will be received for auditing purposes. A list of all changes is the starting point for the auditor when testing the change management criteria and this integration will make compliance with the change management criteria much more efficient.

This integration will only export and track all change request tickets that are relevant to the audit, only the relevant projects' change request tickets will be extracted.
This extraction process is automated by Scytale.

How to connect with the Shortcut integration?

Step 1: Generate an API Key in Shortcut

  • Log in to Shortcut https://app.shortcut.com as an admin.

  • Click on your profile icon in the bottom left corner.

  • Select Settings. 

  • Go to "API Tokens" in the left menu.

  • Add a "Token Name".

  • Click on "Generate Token".





Step 2: Log in to the Scytale web app

  • Click on the "Integrations" menu screen on the left-hand side.
  • Click on the Connect button under the Shortcut icon.
  • Connection Name - is used to differentiate between your connections.
    For instance, if you manage multiple accounts or would like to connect multiple times to the integration. It's automatically titled (Connection 1,2,3 etc), but you can change it to a custom name to make it easier to identify.
  • Paste the API Token that you generated in Shortcut.
  • Click "Connect".


Step 3: Project Selection

  • Select the Shortcut projects that are relevant to the audit.
  • In case your team doesn't work with projects (e.g teams), the last option in the dropdown "Stories that are not linked to projects" allows you to fetch stories that aren't linked to any project.

Note: This is a mandatory step for connecting the integration and collecting evidence.


Permissions for the integration with Shortcut:


The permissions granted give access to read and collect the stories in Shortcut in the relevant projects you have chosen. Scytale collects the evidence automatically with read-only permissions.