Skip to Content
NotificationsManage preferences

Notifications — Manage Preferences

The notifications tab under Account settings and the tenant Settings → Notifications page in the app currently show an older set of category names than the ones in this guide. Until that’s updated, manage preferences through the API or MCP path below — changes made there take effect immediately for delivery, whichever path you use.

Global preferences

Global preferences are your default for every tenant you belong to, unless a per-tenant override (below) exists for a given tenant.

Via MCP: update_my_notification_preferences(categories={"tenant.feature_toggled": false}, scope="global").

Per-tenant preferences

A per-tenant override takes precedence over your global setting, but only for that tenant — it lets you opt in to a category for one tenant while keeping it off globally, or opt out for one tenant while keeping it on elsewhere.

Via MCP (tenant-scoped): update_my_notification_preferences(categories={"hubspot.integration_disconnected": true}, scope="tenant"). The scope="tenant" parameter scopes the preference to the currently active tenant in your JWT.

Always-on categories

The following categories cannot be disabled:

  • account.invite_received
  • account.gdpr_export_ready
  • org_billing.suspended_nonpayment
  • org_billing.purge_warning

Bulk opt-out

There’s no “Opt out of all optional notifications” button in the app yet. Use MCP: unsubscribe_all(scope="global") (every tenant) or unsubscribe_all(scope="tenant") (the currently active tenant only). Always-on categories are never affected by either.

Admin view

There’s no “Subscriber list” view in the app yet. Tenant owners and admins with tenant:notifications:read can see which members are subscribed to which categories via MCP: list_notification_subscribers(category?).

Viewing your send log

There’s no “Send history” view in the app yet. Use MCP: list_notification_log(category?, before?, limit?) (requires tenant:notifications:audit:read) to see this tenant’s send log, newest first, optionally filtered by category and paginated with before.