Import from Shortcut

Migrate your Shortcut (formerly Clubhouse) stories and epics into Superthread using our Shortcut API integration. We’ll preserve your data structure, including stories, epics, workflows, and more.

​

Prerequisites

Before starting the import process, ensure you have:

1. A Shortcut API token with sufficient permissions
   • Create one at https://app.shortcut.com/settings/account/api-tokens
2. Stories that belong to a team (stories without a team will not be imported)

​

Getting started

To start a Shortcut import:

1. Go to Settings > Workspace > Importers
2. Select Shortcut from the available import options
3. Enter your Shortcut API token
4. Review and confirm the import options before proceeding

​

Data mapping

We’ll map your Shortcut data to Superthread fields as follows:

​

Workflow mapping

• Shortcut workflows are converted to Superthread boards
• Each state in the workflow becomes a list in the board
• A board is created for each “Team - Workflow” combination
• Epics are imported as parent cards to a dedicated “Epics” board

​

After import

• All imported cards include a link back to their original Shortcut location
• You can view your import history in Settings > Workspace > Importers
• Severity and Skill set tags are created at the workspace level
• You can delete these tags from the workspace tags settings page if no longer needed

​

Best practices

• Include Epics in your import to preserve story relationships
• Review and organize your boards after import
• Consider which tags you want to keep or remove
• Map team members to ensure proper assignment

​

Need help?

If you encounter any issues during the import process, get in touch with our support team.