Creates a single work item.

External Documentation

To learn more, visit the Azure DevOps documentation.

​
Parameters

ParameterDescription
FieldsA 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”.
OrganizationThe Azure DevOps Organization. You can view the Organizations list in the Azure DevOps Organizations page.
ProjectThe Project ID or Project name. You can view the Projects list in the Azure DevOps Projects page.
TypeThe 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