Create Work Item

Creates a single work item.

External Documentation

To learn more, visit the Azure DevOps documentation.

Parameters

Parameter	Description
Fields	A JSON array of field objects to add to the created work item: "value" - the value to fill in the field. "path" - the path of the field to be filled. Set to "/fields/System.Field Name" in case of a pre-existing field or to "/fields/Custom.Field Name in case of a custom field. Examples of common fields: System.Title, System.Description, System.State, System.Reason, System.Tags, System.AreaPath, System.IterationPath. "from" - set to null. "op" - set to "add".
Organization	The Azure DevOps Organization. You can view the Organizations list in the Azure DevOps Organizations page.
Project	The Project ID or Project name. You can view the Projects list in the Azure DevOps Projects page.
Type	The work item type of the work item to create (Task, Issue, Epic, Test Case, Test Plan, Test Suite or any custom work item type).

Example Output

{
    "id": 131489,
    "rev": 1,
    "fields": {
        "System.AreaPath": "CustomProcessPrj",
        "System.TeamProject": "CustomProcessPrj",
        "System.IterationPath": "CustomProcessPrj",
        "System.WorkItemType": "Task",
        "System.State": "New",
        "System.Reason": "New",
        "System.CreatedDate": "2017-10-06T01:04:51.57Z",
        "System.CreatedBy": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
                "avatar": {
                    "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
                }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        },
        "System.ChangedDate": "2017-10-06T01:04:51.57Z",
        "System.ChangedBy": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
                "avatar": {
                    "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
                }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        },
        "System.Title": "Sample task",
        "Microsoft.VSTS.Common.StateChangeDate": "2017-10-06T01:04:51.57Z",
        "Microsoft.VSTS.Common.Priority": 2
    },
    "_links": {
        "self": {
            "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
        },
        "workItemUpdates": {
            "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/updates"
        },
        "workItemRevisions": {
            "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/revisions"
        },
        "workItemHistory": {
            "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/history"
        },
        "html": {
            "href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=20cda608-32f0-4e6e-9b7c-8def7b38d15a&id=131489"
        },
        "workItemType": {
            "href": "https://dev.azure.com/fabrikam/aaee31d9-14cf-48b9-a92b-3f1446c13f80/_apis/wit/workItemTypes/Task"
        },
        "fields": {
            "href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
        }
    },
    "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
}

Workflow Library Example

Create Work Item with Azure Devops and Send Results Via Email

Preview this Workflow on desktop