---
title: "set_notification_preferences"
method: POST
path: "/tools/set_notification_preferences"
tags: ["Account"]
---

# set_notification_preferences

`POST /tools/set_notification_preferences`

## Request

- Base URL: `https://compabase.com/api/mcp`
- URL: `https://compabase.com/api/mcp/tools/set_notification_preferences`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get or update email notification preferences for watchlist changes.
When `email_notifications` is true, Compabase emails you when a watched
company's data changes (registry updates, new financials, deregistration).

**Does not consume `mcp_queries` quota.**

**Example prompts:** “Turn on watchlist email alerts.” · “What are my notification settings?”

**Parameters:** `action` (required: `get` / `set`), `email_notifications` (boolean, required for set),
`notification_email` (optional override; omit to use the account email).

## Response `200`

Current or updated notification preferences

- object

---

[API](https://skmtc.dev/compabase/apis/compabase-mcp.md) · [All operations](https://skmtc.dev/compabase/apis/compabase-mcp/llms.txt) · [OpenAPI document](https://skmtc.dev/compabase/apis/compabase-mcp/revisions/43169ccbb0f7?raw)