Skip to main content

WorkflowPreferences

Per-workflow notification channel preferences for a subscriber.

Usage profiles​

UsageFields and validation
In responsesView fields

In responses​

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
workflowIdstringOptionalNovu workflow identifier (slug).
workflowNamestringOptionalHuman-readable display name.
criticalbooleanOptionalIf true, subscriber cannot opt out (admin-enforced).
tagsArray of stringOptionalWorkflow tags for grouping in settings UI.
channelsChannelTogglesOptionalChannel switches recorded for these subscriber preferences.

Where used​

ReferenceRelationship
Get notification preferencesPOST /api/v1/notifications/get-preferences
Get the caller's subscriber profilePOST /api/v1/notifications/manage/get-subscriber

Download the public reference contract.

Document: DOC-API-MODEL-workflow-preferences.