Arkweaver + Shortcut integration

Arkweaver creates Shortcut stories from revenue-ranked customer demand, keeps status in sync, and emails the accounts that asked once a story is marked Built.

What syncs between Arkweaver and Shortcut

  • Arkweaver creates stories in Shortcut using the "feature" story type, with the actual customer context attached.
  • Arkweaver keeps status in sync as work moves through Shortcut.
  • Arkweaver reads your Shortcut workflow states so you can map them to its four feature statuses.
  • When a story is marked Built, Arkweaver emails the specific customers and prospects who asked for that feature.
  • Arkweaver tracks those accounts for 28 days afterwards for new sales conversations, meetings booked, and reactivated deals.

How to connect Shortcut to Arkweaver

  1. Go to Settings, then Group Settings, then the Integrations tab, and add the Shortcut integration.
  2. Generate an API token from your Shortcut account settings. Make sure "Read-Only" is unchecked, or Arkweaver will not be able to create stories.
  3. Paste the token into Arkweaver. It fetches your Shortcut workflow states automatically.
  4. Map each of Arkweaver’s four feature statuses to the matching Shortcut state.

What you can do once connected

  • Run the full loop on a lighter-weight tracker without moving your team to Jira or Linear.
  • Push a feature Arkweaver has surfaced into your Shortcut backlog directly from the feature page.
  • Create a story with real customer context instead of a placeholder description.
  • Let the "Create Story" action on any Arkweaver feature start the whole downstream workflow.

Frequently asked questions

What kind of Shortcut item does Arkweaver create?

Stories, created as the "feature" story type, with the customer context behind the request attached so whoever picks up the work has more than a placeholder description.

Why does my Shortcut API token need write access?

Arkweaver creates stories in Shortcut, so a read-only token cannot complete the integration. When you generate the token in your Shortcut account settings, leave "Read-Only" unchecked.

How do Shortcut workflow states line up with Arkweaver?

Arkweaver fetches your workflow states as soon as you paste the token, then you map each of its four feature statuses to the matching Shortcut state. Status stays in sync from there.

More on why this matters: Shortcut and Arkweaver