Create story

Creates a new story in your Shortcut workspace.

Developer info

API endpoint slug: shortcut.create_story
Filter code method: Shortcut.createStory.skip(string?: reason)
Runtime method: runAction("shortcut.create_story", {})

Action fields

Name Text input > Title

Label: Story Name
Helper text: Example: Deploy new feature X
Slug: name
Required: true
Can have default value: true

Description Text input > Long text

Label: Description
Helper text: Detailed plan for deploying new feature X...
Slug: description
Required: false
Can have default value: true
Filter code method: Shortcut.createStory.setDescription(string: description)

Story type Dropdown list

Label: Story Type
Helper text: Example: Feature
Slug: story_type
Required: true
Can have default value: true
Filter code method: Shortcut.createStory.setStory Type(string: story_type)

Owners Checkboxes

Label: Owners
Helper text: Select owners from the list.
Slug: owners
Required: false
Can have default value: false

Epic Dropdown list

Label: Epic
Slug: epic
Required: false
Can have default value: false

Team and workflow state Nested dropdown list

Label: Team and Workflow State
Helper text: The team and workflow state for this story.
Slug: team_and_workflow_state
Required: true
Can have default value: false

Iteration Dropdown list

Label: Iteration
Slug: iteration
Required: false
Can have default value: false

Estimate Text input > Other

Label: Estimate (Story Points)
Helper text: Example: 5
Slug: estimate
Required: false
Can have default value: true
Filter code method: Shortcut.createStory.setEstimate(string: estimate)

External links csv Text input > Other

Label: External Links (comma-separated URLs)
Helper text: Example: http://example.com/spec,http://example.com/mockup
Slug: external_links_csv
Required: false
Can have default value: true
Filter code method: Shortcut.createStory.setExternal Links Csv(string: external_links_csv)

Requested by Dropdown list

Label: Requested By
Slug: requested_by
Required: false
Can have default value: false

Followers Checkboxes

Label: Followers
Helper text: Select followers from the list.
Slug: followers
Required: false
Can have default value: false

Deadline Text input > ISO 8601 date and time

Label: Deadline
Helper text: Example: 2024-12-31T23:59:59Z
Slug: deadline
Required: false
Can have default value: true
Filter code method: Shortcut.createStory.setDeadline(string: deadline)