---
title: "Update notification preferences"
method: PATCH
path: "/v1/company_memberships/notification_preferences"
tags: ["Company membership"]
---

# Update notification preferences

`PATCH /v1/company_memberships/notification_preferences`

Updates the authenticated user's notification preferences for their
membership in the current company. The `preferences` object maps each
known notification type to a channel map. Valid channels are `in_app` and
`email`; valid modes are `immediate`, `daily`, `weekly`, `disabled`. Unknown
types, channels or modes return `422`.

## Parameters

- `#/paths/~1v1~1users/get/parameters/0` — unresolved $ref

## Request body

- object
  - `preferences` object, required — Map of notification type to `{ in_app, email }` mode map. Each mode is one of `immediate`, `daily`, `weekly`, `disabled`.

## Response `200`

The updated notification preferences.

- object
  - `notification_preferences` object

## Other responses

- `401` — Unauthorized
- `404` — Membership not found
- `412` — `preferences` is required.
- `422` — Invalid notification type, channel or mode.

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)