View as Markdown
Azure DevOps icon

Azure DevOps ACTION

Create Work Item

Create a work item of any type - Bug, Task, User Story, Epic. Returns the new work item's id and full field set. Use when turning an alert, form submission or support ticket into tracked work. Example: type Bug, title Checkout returns 500 on empty cart, assigned to jamal@fabrikam.com. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Azure DevOps account once, then configure and run Create Work Item from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "azure_devops-create-work-item",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    azure_devops: { authProvisionId: "apn_xxxxxxx" },
    organization: "Organization",
    project: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Work Item inputs
Property Type Description
organization Organization string
Name of the organization
Required Dynamic
project Project string
Project ID or project name. Run the List Projects action first to obtain valid values.
Required
workItemType Work Item Type string
Work item type, e.g. Bug, Task, User Story. Run the List Work Item Types action first to obtain valid values.
Required
title Title string
Title of the work item (max 255 chars)
Required
description Description string
Description of the work item. HTML is supported.
Optional
assignedTo Assigned To string
Email address or display name of the user to assign the work item to. Run the List Users action first to obtain valid values.
Optional
areaPath Area Path string
Area path, e.g. MyProject\Team A. Run the List Classification Nodes action first to obtain valid values.
Optional
iterationPath Iteration Path string
Iteration path, e.g. MyProject\Sprint 1. Run the List Classification Nodes action first to obtain valid values.
Optional
tags Tags string[]
Tags to apply to the work item
Optional
additionalFields Additional Fields object
Any other work item fields to set, keyed by reference name. Example: { "Microsoft.VSTS.Common.Priority": 1 }. Run the List Work Item Fields action first to obtain valid reference names.
Optional
expand Expand string
Additional work item attributes to include in the response
Optional
bypassRules Bypass Rules boolean
Do not enforce work item type rules on this change. Requires membership of the Project Collection Service Accounts group.
Optional
suppressNotifications Suppress Notifications boolean
Do not fire any notifications for this change
Optional
validateOnly Validate Only boolean
Validate the change without saving the work item
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
azure_devops-create-work-item
Version
0.0.2
App
Azure DevOps
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes