# IRPCEvents.SetNotificationConfiguration

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md) > [Events and notifications](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEvents/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEvents/SetNotificationConfiguration/

Badges: `Vault API / standard` `write` `session` `idempotent` `returns metadata structure version`

Turns notifications on or off for the caller.

- **Service:** [Events and notifications](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEvents/index.md) `MFiles.IRPCEvents`
- **gRPC method:** `/MFiles.IRPCEvents/SetNotificationConfiguration`
- **HTTP (mf-http-grpc):** `POST /grpc/v1/set-notification-configuration`
- **Request:** [`SetNotificationConfigurationRequest`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEvents/SetNotificationConfiguration/index.md#request)
- **Response:** [`SetNotificationConfigurationResponse`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEvents/SetNotificationConfiguration/index.md#response)
- **Book and level:** Vault API, standard
- **Kind:** write
- **Session:** Required: the session ID from LogIn in the mfiles-session-id-bin metadata.
- **Idempotent:** yes
- **Returns metadata structure version:** yes (in the mfiles-metadata-version-bin trailer)
- **Streaming:** none (unary)

<a id="remarks"></a>

## Remarks

- Requires a vault session. No special vault rights are needed. Affects only the caller.
- Only `is_enabled` may be set; any other flag fails with "The parameter is incorrect.".

<a id="request"></a>

## Request: SetNotificationConfigurationRequest

> Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

| Field | Type | Description |
|---|---|---|
| `flags` | [`NOTIFICATIONFLAGS`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.NOTIFICATIONFLAGS/index.md) | Set `is_enabled` to true to receive notifications, or leave all flags unset to stop them. |
| `flags.all` | `bool` | Specifies all flags set; Including any future flags. |
| `flags.is_enabled` | `bool` | Notifications enabled. |
| `flags.send_digest` | `bool` | Combine the day's notifications into a single message. |
| `flags.exclude_self_triggered` | `bool` | Exclude notifications of events caused by me. |
| `flags.recurring` | `bool` | Notifications are recurring (not only appear once per a matching object). |

<a id="response"></a>

## Response: SetNotificationConfigurationResponse

No fields.