Shortcut (formerly Clubhouse)

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

To configure this integration, you must be a TeamRetro Team Administrator.

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


  1. Log into TeamRetro and navigate to the team you want to integrate Shortcut with.
  2. Click on SETTINGS, followed by INTEGRATIONS and look for Shortcut. 


  3. 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.

  4. Once the Token is validated, you will be asked to select the Project you would want to publish your action items to.

  5. Once the connection succeeds, click SAVE CHANGES and 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.

Action items will only be published as stories in the selected Project in Shortcut.

Still need help? Contact Us Contact Us