---
title: "Update account notification preferences"
method: PATCH
path: "/notification-preferences"
tags: ["Notification Preferences"]
---

# Update account notification preferences

`PATCH /notification-preferences`

Changes which account notifications Sequenzy emails the API key's own user for the active company. Events not listed keep their current value. Useful before a bulk import or migration, though imports never trigger new-subscriber notifications in the first place. Requires companies:manage; account:read alone cannot mutate these settings.

## Request body

- object
  - `notificationPreferences` NotificationPreference[], required — Preferences to set. Events not listed are left unchanged.
    - `event` 'new_subscriber' | 'campaign_completed', required — Which notification to configure.
    - `mode` 'off' | 'instant' | 'daily', required — How to receive it. "instant" sends one email per occurrence, "daily" one summary per day. "daily" is not supported for campaign_completed.

## Response `200`

Notification preferences updated

- NotificationPreferences
  - `success` boolean
  - `notificationPreferences` NotificationPreference[] — Every notification event with its current mode, defaults included.
    - `event` 'new_subscriber' | 'campaign_completed', required — Which notification to configure.
    - `mode` 'off' | 'instant' | 'daily', required — How to receive it. "instant" sends one email per occurrence, "daily" one summary per day. "daily" is not supported for campaign_completed.
  - `supportedModes` object — Modes each event accepts, keyed by event.
  - `defaults` object — Mode each event uses when the user has never configured it.

## Other responses

- `400` — Unsupported event or mode. "daily" is not valid for campaign_completed.
- `401` — Unauthorized

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/versions/af1cf9620482/schema)