---
title: "Create a new notification rule or update an existing notification rule."
method: PATCH
path: "/notification-rules/{notificationRuleId}"
tags: ["NotificationRule"]
---

# Create a new notification rule or update an existing notification rule.

`PATCH /notification-rules/{notificationRuleId}`

Create a new notification rule or update an existing notification rule by providing the notification rule Id.

## Path parameters

- `notificationRuleId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- NotificationRule — Notification rule model.
  - `notificationRuleId` string, required — The unique identifier of the notification rule.
  - `displayName` string, required — The name of the notification rule.
  - `actionGroupIds` string[], required — The action groups to notify.
  - `scope` 'Tests', required — Scope type of a notification rule.
  - `createdDateTime` string, date-time — The creation datetime(RFC 3339 literal format).
  - `createdBy` string — The user that created.
  - `lastModifiedDateTime` string, date-time — The last Modified datetime(RFC 3339 literal format).
  - `lastModifiedBy` string — The user that last modified.

## Other responses

- `201` — The request has succeeded and a new resource has been created as a result.
- `default` — An unexpected error response.

## Changes

- **2025-06-26** (2022-11-01) `e991fe514f8b` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/loadtestservice-loadtesting/changes/notification-rules/:notificationRuleId/patch.md)

---

[API](https://skmtc.dev/azure/apis/loadtestservice-loadtesting.md) · [All operations](https://skmtc.dev/azure/apis/loadtestservice-loadtesting/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/loadtestservice-loadtesting/revisions/a39805b6167f/schema)