Workflow schema Model API Reference (Workflows)
Reference the Novu workflow schema used in API requests and responses. Review fields, data types, and object structure for this resource.
Workflow
In Novu, a workflow defines the logic for delivering notifications based on specific events. It consists of configurable steps that control timing, conditions, and which channels to use, such as email, SMS, or in-app messages. Workflows can be built visually in the dashboard or programmatically using the Novu Framework. Each workflow has a unique identifier, supports environment syncing, and provides real-time visibility through the Activity Feed for monitoring and debugging.. Read more about workflows on workflows concept page.
| Prop | Type | Default |
|---|---|---|
workflowIntegrationStatus? | WorkflowIntegrationStatus | - |
data? | WorkflowResponseData | - |
notificationGroup? | NotificationGroup | - |
deletedBy? | string | - |
deletedAt? | string | - |
deleted? | boolean | - |
parentId? | string | - |
notificationGroupId? | string | - |
triggers? | NotificationTrigger[] | - |
environmentId? | string | - |
creatorId? | string | - |
organizationId? | string | - |
steps? | NotificationStepDto[] | - |
tags? | string[] | - |
critical? | boolean | - |
preferenceSettings? | SubscriberPreferenceChannels | - |
draft? | boolean | - |
active? | boolean | - |
description? | string | - |
name? | string | - |
id? | string | - |
Retrieve an event GET
Retrieve an event by its unique key identifier **notificationId**. Here **notificationId** is of mongodbId type. This API returns the event details - execution logs, status, actual notification (message) generated by each workflow step.
Create a workflow POST
Creates a new workflow in the Novu Cloud environment