> ## 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.

# Get Notification Preferences

> Get your account notification settings for the current company

Get which account notifications Sequenzy emails you about this workspace: when a contact joins, and when a campaign finishes sending.

These are per-person settings. This endpoint always acts on the API key's own user, and there is no way to read a teammate's preferences through the API.

This endpoint requires the `account:read` scope.

## Request

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/notification-preferences" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response fields

<ResponseField name="notificationPreferences" type="array">
  Every notification event with its current mode. Events you have never
  configured report the platform default rather than being omitted, so the array
  always has one entry per event.
</ResponseField>

<ResponseField name="notificationPreferences[].event" type="string">
  `new_subscriber` or `campaign_completed`.
</ResponseField>

<ResponseField name="notificationPreferences[].mode" type="string">
  `off`, `instant` (one email per occurrence), or `daily` (one summary per day).
</ResponseField>

<ResponseField name="supportedModes" type="object">
  Modes each event accepts, keyed by event. `campaign_completed` does not accept
  `daily`.
</ResponseField>

<ResponseField name="defaults" type="object">
  Mode each event uses when you have never configured it.
</ResponseField>

## Responses

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

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

See [Account Notifications](/concepts/account-notifications) for when each notification fires and how the daily cap works.