Create Work Items via URL

SetGet supports creating work items through a specially formatted URL. When a user opens this URL, SetGet loads the work item creation form with specified fields pre-filled. This is useful for building links in email templates, support tools, chatbots, wikis, and automation pipelines that need to feed work into SetGet without requiring manual data entry.

Base URL format

The creation URL follows this structure:

https://app.setget.dev/{workspace-slug}/{project-id}/work-items/new?param=value

Segment	Description
{workspace-slug}	The URL-friendly slug of the target workspace (e.g., my-team)
{project-id}	The identifier of the target project (e.g., web-app)
/work-items/new	The path that opens the creation form
?param=value	Query parameters to pre-fill fields

If workspace and project are specified as query parameters instead of path segments, the URL can also be written as:

https://app.setget.dev/work-items/new?workspace=my-team&project=web-app&title=Bug+report

Supported query parameters

The following parameters can be included in the URL to pre-fill the creation form:

Parameter	Type	Description	Example
title	String	Pre-fills the work item title	title=Fix+login+timeout
description	String	Pre-fills the description field (plain text)	description=Steps+to+reproduce...
priority	String	Sets the priority level	priority=high
state	String	Sets the initial workflow state	state=backlog
assignee	String	Assigns a member by email or member ID	assignee=alice@example.com
label	String	Adds a label by name or ID (repeatable)	label=bug&label=frontend
workspace	String	Selects the workspace by slug	workspace=my-team
project	String	Selects the project by identifier or slug	project=web-app
cycle	String	Associates the item with a cycle by ID or name	cycle=sprint-12
module	String	Associates the item with a module by ID or name	module=auth-revamp
due_date	Date	Sets the due date (ISO 8601 format)	due_date=2026-04-15
start_date	Date	Sets the start date (ISO 8601 format)	start_date=2026-04-01
estimate	Number	Sets the effort estimate	estimate=5
parent	String	Sets a parent work item by identifier	parent=WEB-10

Priority values

The priority parameter accepts the following values (case-insensitive):

Value	Priority level
urgent	Urgent
high	High
medium	Medium
low	Low
none	None (default)

State values

The state parameter matches against the state names defined in the target project. Common defaults include:

• backlog
• todo
• in_progress or in progress
• done
• cancelled

If the provided state name does not match any state in the project, the form falls back to the project's default state.

URL encoding

Query parameter values must be URL-encoded. Spaces should be encoded as + or %20. Special characters must use percent-encoding.

Character	Encoded form
Space	+ or %20
&	%26
=	%3D
/	%2F
@	%40
#	%23

Example with special characters:

https://app.setget.dev/my-team/web-app/work-items/new?title=Fix+%22login%22+timeout+%26+retry+logic&priority=high&assignee=alice%40example.com

This pre-fills the title as: Fix "login" timeout & retry logic

Multiple labels

To apply more than one label, repeat the label parameter:

?label=bug&label=frontend&label=urgent

Each label value is matched against the labels defined in the target project. Labels that do not match any existing label name are ignored.

Full example URL

Here is a complete example that pre-fills most available fields:

https://app.setget.dev/my-team/web-app/work-items/new?title=Dashboard+loading+spinner+stuck&description=The+dashboard+shows+a+loading+spinner+indefinitely+after+refreshing.&priority=high&state=todo&assignee=alice@example.com&label=bug&label=dashboard&due_date=2026-04-10&cycle=sprint-12&estimate=3

When a user opens this link, they see the creation form with all fields pre-populated. They can review, modify any field, and click Create Work Item to save.

TIP

The user always has the opportunity to review and edit pre-filled values before creating the work item. The URL only sets defaults — it does not bypass the creation form.

Use cases

Email templates

Include a creation link in your support email templates so that customer-facing team members can log work items with one click:

Report this as a bug: https://app.setget.dev/support-team/product/work-items/new?title=Customer+reported:+{subject}&label=customer-report&priority=medium

External tools and help desks

Connect your help desk or monitoring tool to SetGet by generating URLs dynamically. When an alert fires or a ticket is created, build a creation URL with the relevant details pre-filled.

Wiki and documentation links

Embed creation links in your internal wiki pages. For example, a page about the deployment process might include:

[Report a deployment issue](https://app.setget.dev/eng/platform/work-items/new?title=Deployment+issue&label=ops&priority=high)

Chatbot and automation workflows

If you use a chatbot or workflow automation tool, generate SetGet creation URLs from collected inputs and send them to team members for review and submission.

Onboarding checklists

Create pre-filled links for common onboarding tasks so that new team members can submit their setup items quickly:

[Request laptop setup](https://app.setget.dev/ops/it-requests/work-items/new?title=Laptop+setup+for+new+hire&label=onboarding&assignee=it-admin@example.com)

WARNING

Do not include sensitive data (passwords, tokens, personal information) in URL parameters. URLs may be logged in browser history, server access logs, and analytics tools.

Behavior when parameters are invalid

Situation	Behavior
Workspace slug does not exist	User is redirected to workspace selection
Project does not exist	User sees a project-not-found message
Assignee email not found in workspace	Assignee field is left empty
Label name does not match	Label is ignored; other valid labels still apply
State name does not match	Default project state is used
Priority value invalid	Priority defaults to None
Date format invalid	Date field is left empty

Related pages

• Work Item Overview — Standard work item creation methods
• Work Item Properties — Full property reference
• Draft Work Items — Save incomplete items as drafts
• Templates — Create items from reusable templates
• Bulk Operations — Create and update items in batch