Integrations / Project management

Shortcut

Search and look up Shortcut stories, create, update and comment on them, and trigger workflows when stories, epics and comments change.

10 tools 12 trigger events

Tools

shortcut.search_stories

Search stories with Shortcut's search operators. Story IDs are numbers like 1234; owner IDs are member UUIDs from list_members; workflow_state_id names a state from list_workflows.

query*page_sizenext

shortcut.get_story

Get a story with its description, tasks and comments.

story_id*

shortcut.create_story writes

Create a story. Without a workflow state it lands in the default workflow's first state.

name*descriptionstory_typeworkflow_state_idowner_idsepic_iditeration_idgroup_idestimatedeadlinelabels

shortcut.update_story writes

Change a story's fields; only what you pass changes. Move it between states with workflow_state_id.

story_id*namedescriptionstory_typeworkflow_state_idowner_idsepic_iditeration_idestimatedeadlinearchived

shortcut.add_comment writes

Add a comment to a story.

story_id*text*

shortcut.list_workflows

List workflows and their states, with the state IDs create_story and update_story need. State types are unstarted, started or done.

shortcut.list_members

List the workspace's active members with the UUIDs that owner_ids take.

shortcut.list_iterations

List iterations (sprints) with their IDs, dates and status: unstarted, started or done.

shortcut.api_get

Send a GET request to any Shortcut API path under https://api.app.shortcut.com/api/v3 and return the response. For endpoints the named tools don't cover.

path*params

shortcut.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Shortcut API path under https://api.app.shortcut.com/api/v3.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any Shortcut API path.

Connect

In Shortcut, open Settings → Your Account → API Tokens (app.shortcut.com/settings/account/api-tokens), generate a token and copy it. It isn't shown again.
Paste it as the connection's API token. The connection acts as that token's member.
To trigger workflows, open Settings → Integrations → Webhooks (app.shortcut.com/settings/integrations/outgoing-webhook), add a webhook with the request URL shown on the connection page and a secret, and paste the same secret on the connection.

Credentials

API token Webhook secret

Shortcut API docs

Triggers

In Shortcut, open Settings → Integrations → Webhooks, add a webhook with this URL and a secret, and paste the same secret on this connection. A delivery's actions list what changed, each with the entity's id; the first one names the event.

Events

story.createstory.updatestory.deletestory-comment.createstory-comment.updatestory-comment.deletestory-task.createstory-task.updateepic.createepic.updateepic.deleteepic-comment.create

 triggerkind: shortcut
connection: shortcut
events: [story.create]
story_types: [...]

Turn one person's AI process into the company's.

Murmurator is invite-only. Already invited? Sign in and build something real.