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

# Notification Settings

> Manage a brand's email notifications, client-report recipients, and their frequencies.

Read a brand's notification preferences — weekly reports, monthly audits, new opportunities, resource-usage warnings — plus the list of client-report recipients and the cadence each one receives.

<Note>
  Reading requires any team **member**. The `GET` route auto-creates default settings on first read.
</Note>

### GET response fields

| Field                  | Description                                                  |
| ---------------------- | ------------------------------------------------------------ |
| `weeklyReports`        | Send the weekly performance report.                          |
| `monthlyAudits`        | Send the monthly site audit.                                 |
| `newOpportunities`     | Notify on new opportunities.                                 |
| `resourceUsageWarning` | Warn when resource/credit usage is running low.              |
| `clientReportsEnabled` | Master switch for client-report delivery.                    |
| `reportRecipients`     | Array of client-report recipients (see below).               |
| `whiteLabelAvailable`  | Read-only flag: whether the plan allows white-label reports. |

Each entry in `reportRecipients` has:

| Field        | Description                                    |
| ------------ | ---------------------------------------------- |
| `email`      | Recipient email (lowercased).                  |
| `weekly`     | Include in the weekly report.                  |
| `monthly`    | Include in the monthly report.                 |
| `whiteLabel` | Send this recipient the white-labeled version. |

***

## Update Notification Settings

`PATCH /v3/settings/notifications`

Update any subset of the fields above. Only the keys you send are changed; the merged, canonical settings are returned.

<Note>
  Writing requires **managed** (admin/owner) access to the brand.
</Note>

<Warning>
  `reportRecipients` is sanitized on write: emails are trimmed, lowercased, and deduplicated; entries with an invalid email or with **both** `weekly` and `monthly` off are dropped; and the list is capped at **10** recipients. `whiteLabelAvailable` is read-only and ignored if sent.
</Warning>