Shortcut (formerly Clubhouse)

You can integrate your TeamRetro team with your Shortcut project, and automatically publish team action items as Shortcut stories. 

Create your Shortcut API token

1. Sign in to your Shortcut.com workspace .

   e.g. https://app.shortcut.com/{organizationName}

2. Open the user settings by clicking on your icon, followed by Settings.

   

3. Click on API Tokens on the left navigation panel, input a name for the token (e.g. TeamRetro), and click on Generate Token

4. Once that is done, a unique API Token will be generated for you.

   NOTE: copy this token to the clipboard as this will be the only time it is displayed to you. 

   

Configure in TeamRetro

• Log into TeamRetro and navigate to the team you want to integrate Shortcut with.

• Click on SETTINGS, followed by INTEGRATIONS and look for 'Shortcut'. 

  

  
  
• Once you click on CONNECT you will be asked to input the API Token that was generated within Shortcut. To confirm the API Token, click on NEXT (->) to continue.
• Once the Token is validated, you will be asked to select the Project you would want to publish your action items to.

• Once the connection succeeds, you will see that it is connected back on the INTEGRATIONS page.

  

Testing your integration

Back on your team > HOME screen, you can click the PUBLISH icon and you will see SHORTCUT as an option. After selecting, TeamRetro will create a new Story in Shortcut and display the corresponding Story ID on the card. Note: action items will only be published as stories in the selected Project in Shortcut.