> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Work Item

Creates a single work item.

<Note>
  External Documentation

  To learn more, visit the [Azure DevOps documentation](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/create?view=azure-devops-rest-7.1\&tabs=HTTP).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
  | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Fields       | A JSON array of field objects to add to the created work item:<br /><br />"value" - the value to fill in the field.<br /><br />"path" - the path of the field to be filled. Set to "/fields/System.`Field Name`" in case of a pre-existing field or to<br />"/fields/Custom.`Field Name` in case of a custom field. Examples of common fields: System.Title, System.Description,<br />System.State, System.Reason, System.Tags, System.AreaPath, System.IterationPath.<br /><br />"from" - set to null.<br /><br />"op"   - set to "add". |
  | Organization | The Azure DevOps Organization. You can view the Organizations list in the [Azure DevOps Organizations page](https://portal.azure.com/#blade/AzureTfsExtension/OrganizationsTemplateBlade).                                                                                                                                                                                                                                                                                                                                                |
  | Project      | The Project ID or Project name. You can view the Projects list in the [Azure DevOps Projects page](https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.DevCenter%2Fprojects).                                                                                                                                                                                                                                                                                                                              |
  | 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).                                                                                                                                                                                                                                                                                                                                                                                                         |
</div>

## Example Output

```json theme={"dark"}
{
	"id": 999,
	"rev": 310,
	"fields": {
		"System.AreaPath": "<string>",
		"System.TeamProject": "<string>",
		"System.IterationPath": "<string>",
		"System.WorkItemType": "<string>",
		"System.State": "<string>",
		"System.Reason": "<string>",
		"System.CreatedDate": "2022-09-26T01:02:05",
		"System.CreatedBy": {
			"displayName": "<string>",
			"url": "<string>",
			"_links": {
				"avatar": {
					"href": "<string>"
				}
			},
			"id": "<string>",
			"uniqueName": "<string>",
			"imageUrl": "<string>",
			"descriptor": "<string>"
		},
		"System.ChangedDate": "2021-12-22T10:49:02",
		"System.ChangedBy": {
			"displayName": "<string>",
			"url": "<string>",
			"_links": {
				"avatar": {
					"href": "<string>"
				}
			},
			"id": "<string>",
			"uniqueName": "<string>",
			"imageUrl": "<string>",
			"descriptor": "<string>"
		},
		"System.CommentCount": 754,
		"System.Title": "<string>",
		"Microsoft.VSTS.Common.StateChangeDate": "2023-06-21T13:44:49",
		"Microsoft.VSTS.Common.Priority": 218,
		"System.Description": "<string>",
		"System.Tags": "<string>"
	},
	"_links": {
		"self": {
			"href": "<string>"
		},
		"workItemUpdates": {
			"href": "<string>"
		},
		"workItemRevisions": {
			"href": "<string>"
		},
		"workItemComments": {
			"href": "<string>"
		},
		"html": {
			"href": "<string>"
		},
		"workItemType": {
			"href": "<string>"
		},
		"fields": {
			"href": "<string>"
		}
	},
	"url": "<string>"
}
```

## Workflow Library Example

[Create Work Item with Azure Devops and Send Results Via Email](https://library.blinkops.com/workflows/create-work-item-with-azure-devops-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-work-item-with-azure-devops-and-send-results-via-email/canvas" />
</div>