> ## 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 Or Update Watchlist Item

Create or update a watchlist item.

<Note>
  External Documentation

  To learn more, visit the [Microsoft Sentinel documentation](https://learn.microsoft.com/en-us/rest/api/securityinsights/watchlist-items/create-or-update?view=rest-securityinsights-2025-09-01\&tabs=HTTP).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter           | Description                                                                                                                                                                                                                                                                                                                                                                        |
  | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Items Key Value     | A JSON object that contains key-value pairs for a watchlist item.<br /><br />**For Example:**<br /><br /><pre><code>\{<br />  "Gateway subnet": "10.0.255.224/27",<br />  "Web Tier": "10.0.1.0/24",<br />  "Business tier": "10.0.2.0/24",<br />  "Data tier": "10.0.2.0/24",<br />  "Private DMZ in": "10.0.0.0/27",<br />  "Public DMZ out": "10.0.0.96/27"<br />}</code></pre> |
  | Resource Group Name | The name of the resource group. The name is case insensitive.                                                                                                                                                                                                                                                                                                                      |
  | Subscription ID     | The ID of the target subscription.                                                                                                                                                                                                                                                                                                                                                 |
  | Watchlist Alias     | The watchlist alias.                                                                                                                                                                                                                                                                                                                                                               |
  | Watchlist Item ID   | The ID of the watchlist item to create or update.<br /><br />**Note:** To create a new watchlist item, a new generated GUID is required.                                                                                                                                                                                                                                           |
  | Workspace Name      | The name of the workspace.                                                                                                                                                                                                                                                                                                                                                         |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                    | Description                                                                        |
  | ---------------------------- | ---------------------------------------------------------------------------------- |
  | Entity Mapping               | A JSON object that represents a key-value map for a watchlist item entity mapping. |
  | Etag                         | The Etag of the azure resource.                                                    |
  | Properties Watchlist Item ID | The ID of the created or updated watchlist item.                                   |
  | Tenant ID                    | The tenant ID to which the watchlist belongs.                                      |
  | Watchlist Item Type          | The type of the created or updated watchlist item.                                 |
</div>

## Example Output

```json theme={"dark"}
{
	"id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Watchlists/highValueAsset/WatchlistItems/82ba292c-dc97-4dfc-969d-d4dd9e666842",
	"etag": "0300bf09-0000-0000-0000-5c37296e0000",
	"type": "Microsoft.SecurityInsights/Watchlists/WatchlistItems",
	"properties": {
		"watchlistItemType": "watchlist-item",
		"watchlistItemId": "82ba292c-dc97-4dfc-969d-d4dd9e666842",
		"tenantId": "4008512e-1d30-48b2-9ee2-d3612ed9d3ea",
		"isDeleted": false,
		"created": "2020-11-15T04:58:56.0748363+00:00",
		"updated": "2020-11-16T16:05:20+00:00",
		"createdBy": {
			"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
			"email": "john@contoso.com",
			"name": "john doe"
		},
		"updatedBy": {
			"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
			"email": "john@contoso.com",
			"name": "john doe"
		},
		"itemsKeyValue": {
			"Gateway subnet": "10.0.255.224/27",
			"Web Tier": "10.0.1.0/24",
			"Business tier": "10.0.2.0/24",
			"Data tier": "10.0.2.0/24",
			"Private DMZ in": "10.0.0.0/27",
			"Public DMZ out": "10.0.0.96/27"
		}
	}
}
```

## Workflow Library Example

[Create or Update Watchlist Item with Microsoft Sentinel and Send Results Via Email](https://library.blinkops.com/workflows/create-or-update-watchlist-item-with-microsoft-sentinel-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-or-update-watchlist-item-with-microsoft-sentinel-and-send-results-via-email/canvas" />
</div>