User Notification Preferences with Novu

Let subscribers control how they receive notifications using Novu’s built-in preference management. The Inbox component includes a preferences UI, and the REST API lets you read and update preferences programmatically.

How do subscriber preferences work in Novu?

Each subscriber has preferences at two levels:

Global channel preferences — opt in or out of email, SMS, push, in-app, and chat globally
Workflow-level preferences — opt in or out of specific workflows

When you trigger a workflow, Novu checks preferences before delivering each channel step.

How do I expose preferences in the Inbox?

The Novu Inbox includes a built-in preferences modal. Enable it in your Inbox configuration:

import { Inbox } from '@novu/react';

<Inbox
  applicationIdentifier="YOUR_APPLICATION_IDENTIFIER"
  subscriberId="YOUR_SUBSCRIBER_ID"
/>

See Inbox preferences configuration for customization options.

How do I update preferences via the API?

Use the Update subscriber preferences endpoint to set preferences from your backend.

curl -X PATCH https://api.novu.co/v2/subscribers/user_123/preferences \
  -H "Authorization: ApiKey <NOVU_SECRET_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "preferences": [
      { "workflowId": "marketing-digest", "enabled": false },
      { "channel": { "type": "sms", "enabled": true } }
    ]
  }'

Frequently asked questions

Can subscribers opt out of specific workflows only?

Yes. Workflow-level preferences let subscribers disable individual workflows while staying subscribed to others such as security alerts.

Do preferences apply to topic broadcasts?

Yes. When triggering a workflow to a topic, Novu respects each subscriber’s preferences before delivering messages.

Multi-Channel Notification Fallback Workflows

Novu Integration Guides and Recipes

⌘I

Use Cases

Guides

Inbound Webhooks

Recipes

Framework

Migrate to Novu

User Notification Preferences with Novu

How do subscriber preferences work in Novu?

How do I expose preferences in the Inbox?

How do I update preferences via the API?

Frequently asked questions

​How do subscriber preferences work in Novu?

​How do I expose preferences in the Inbox?

​How do I update preferences via the API?

​Related guides

​Frequently asked questions

How do subscriber preferences work in Novu?

How do I expose preferences in the Inbox?

How do I update preferences via the API?

Related guides

Frequently asked questions