Shortcut

Issue trackers

Publish approved user stories straight into Shortcut

Spectr drafts the stories. Shortcut is where the approved ones go. Connect a Shortcut workspace with an API token, optionally set a default team, and each approved story arrives with its description, acceptance criteria, estimate, tags and assignee already set. A status refresh reads each story's state back, so your delivery and budget numbers reflect what is really done.

How Shortcut fits in

Import your call. Let Spectr take over.

A call is imported from a note-taker (Fathom, Granola, Read.ai, or Fireflies.ai). Spectr picks out a requirement, a bug, an action item and an out-of-scope ask, and drafts a story and a bug with acceptance criteria. A person approves both, they are published to Shortcut, and the requirements, scope log and project memory update from the same call.

How it connects

API token. You create a token in Shortcut and paste it into the project, then optionally set a default team and the workflow state new stories start in.

Before you start

A Shortcut workspace, and an API token from an account that can create stories in the team you choose.

What Spectr reads from Shortcut

Teams and workflows
Read so you can set an optional default team and starting workflow state. Without them, stories land in the first unstarted state of your first workflow.
Workflow state of published stories
Read per story when you refresh status, from Shortcut's own started and completed flags, onto done, in progress or not started. A story deleted in Shortcut keeps its last known state rather than being wiped.
Tags
Tags applied in Shortcut sync back onto the Spectr story, with the internal priority pseudo-label filtered out.

What Spectr writes to Shortcut

One at a time, each with a result
The publish dialog sends approved stories to Shortcut one by one and shows each result, so a story that fails can be retried on its own.
Estimates, tags and assignee
Mapped onto Shortcut's own fields, with story type resolved from Spectr's feature, bug, chore and spike classification.

Setting it up

  1. In Shortcut, create an API token from your account settings.

  2. In Spectr, open the project, go to Integrations, choose Shortcut and paste the token.

  3. Select the team new stories should be created in, and the workflow state they should start in.

  4. Generate stories from a meeting and review them.

  5. Publish the approved stories. Each story in Spectr links to the Shortcut story it became.

Frequently asked questions

Anything else? Email hello@crowdlinker.com and a person will answer.

Does Shortcut use OAuth?

Spectr connects with a Shortcut API token rather than OAuth. The token is encrypted at rest and can be revoked from Shortcut at any time.

Can Spectr create Shortcut epics?

Spectr publishes stories, and nests them under a parent story when the spec marks a task as a parent. It does not create epics.

Who can stories be assigned to?

Members of your Shortcut workspace, which Spectr syncs into the project team, so an assignee picked in review is a real Shortcut user.

Related

Use case

Write user stories your developers can actually start

Draft stories with real acceptance criteria, then approve, edit or reject each one

See all 20 integrations →

AI ProductOps for the entire team.

Start for free at spectr.pm
  • Free plan
  • No credit card to sign up
  • 30-day free trial on Starter