> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Notification Preferences

> Change your account notification settings for the current company

Change which account notifications Sequenzy emails you about this workspace.

This endpoint requires the `companies:manage` scope. Reading the current values
only requires `account:read`.

Events you do not include keep their current value. The response returns the full set either way, so you never have to merge state yourself.

This endpoint always acts on the API key's own user and can never change a teammate's settings.

## Request

<ParamField body="notificationPreferences" type="array" required>
  Preferences to set. Must contain at least one entry.
</ParamField>

<ParamField body="notificationPreferences[].event" type="string" required>
  `new_subscriber` or `campaign_completed`.
</ParamField>

<ParamField body="notificationPreferences[].mode" type="string" required>
  `off`, `instant`, or `daily`. `daily` is not valid for `campaign_completed` -
  a campaign finishes once, so there is nothing to roll up.
</ParamField>

```bash theme={null}
curl -X PATCH "https://api.sequenzy.com/api/v1/notification-preferences" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"notificationPreferences": [{"event": "new_subscriber", "mode": "daily"}]}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "notificationPreferences": [
      { "event": "new_subscriber", "mode": "daily" },
      { "event": "campaign_completed", "mode": "instant" }
    ],
    "supportedModes": {
      "new_subscriber": ["off", "instant", "daily"],
      "campaign_completed": ["off", "instant"]
    },
    "defaults": {
      "new_subscriber": "off",
      "campaign_completed": "off"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": {
      "code": "VALIDATION_ERROR",
      "message": "\"daily\" is not a supported mode for the campaign_completed notification."
    }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": { "code": "UNAUTHORIZED", "message": "Invalid API key" }
  }
  ```
</ResponseExample>

## Before a bulk import

You do not need to turn notifications off before importing contacts. Imports never trigger new-subscriber notifications, and a high-volume day of real signups automatically falls back to a daily summary. See [Account Notifications](/concepts/account-notifications).