---
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' | 'form_submitted' | '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. Instant form_submitted notifications stop after 50 per workspace per UTC day. "daily" is not supported for form_submitted or campaign_completed.

## Response `200`

Notification preferences updated

- NotificationPreferences
  - `success` boolean
  - `notificationPreferences` NotificationPreference[] — Every notification event with its current mode, defaults included.
    - `event` 'new_subscriber' | 'form_submitted' | '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. Instant form_submitted notifications stop after 50 per workspace per UTC day. "daily" is not supported for form_submitted or 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 form_submitted or campaign_completed.
- `401` — Unauthorized

## Changes

- **2026-08-25** `964634fbc8bf` — 1 warning, 1 info
  - added the new `form_submitted` enum value to the `notificationPreferences/items/event` response property for the response status `200`
  - added the new `form_submitted` enum value to the request property `notificationPreferences/items/event`
- **2026-08-19** `ba3a29c6eb33` — 2 info
  - added the optional property `retryable` to the response with the `400` status
  - added the optional property `retryable` to the response with the `401` status
- **2026-08-16** `6fd2903b91ce` — 2 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
- **2026-08-02** `36f92fc0caa2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/notification-preferences/patch.md)

---

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