Notification Types
WorkDesk has four built-in notification types, each serving a distinct purpose. Understanding the types helps you configure preferences — deciding which should appear in the bell, which should go to email, and which you can safely mute.
hil_task_assigned
HIL Task Assigned
type: "hil_task_assigned"Sent when a workflow routes a HIL task to you (directly or via your role). This is typically the most important notification type — it requires action from you to keep workflows moving.
You have been assigned an approval task in "Expense Approval Flow". Due: 2026-05-27. Open Task →
Priority: High | Default channels: Bell + Email (configurable)
workflow_completed
Workflow Completed
type: "workflow_completed"Sent when a workflow you triggered has finished successfully. Useful for confirming that a process you started has run to completion, especially for long-running workflows (hours or days).
"Expense Approval Flow" triggered by you has completed successfully. View Results →
Priority: Normal | Default channels: Bell only (email opt-in)
hil_task_overdue
HIL Task Overdue
type: "hil_task_overdue"Sent when a task in your inbox has passed its dueAt deadline without action. The workflow is stalled and other participants may be waiting. Requires immediate attention.
"Q1 Budget Review" was due yesterday and is still pending your action. Act Now →
Priority: Urgent | Default channels: Bell + Email + Push (configurable)
system_alert
System Alert
type: "system_alert"Platform-wide announcements from administrators. Includes maintenance windows, feature releases, policy changes, and emergency notices. These are broadcast to all users in a tenant.
BizFirstGO will be unavailable for maintenance on 2026-05-30 from 02:00–04:00 UTC. Save your work before then.
Priority: Normal to Urgent (set by admin) | Default channels: Bell + Email
Notification Type Reference
| Type | Priority | Trigger | Action Required? |
|---|---|---|---|
hil_task_assigned | High | HIL node suspension in workflow | Yes — act on the task |
workflow_completed | Normal | Terminal state of triggered execution | No — informational |
hil_task_overdue | Urgent | Task passes dueAt without action | Yes — urgent |
system_alert | Varies | Admin broadcast | Depends on alert content |