Send Notification
Send an in-app workspace notification to members and/or role holders.
Type
system.notification.sendFolder
notificationChannels
General, Agent tool
Pipe
Value
Scope
Any
Send Notification writes an in-app notification to selected workspace members and/or role holders. Recipients see it in the header bell and on the Notifications page. The graph continues immediately — this is not a wait or an approval.
This type is valid on general and agent-tool workflows, not on chat graphs. Attach it as an agent tool when the model should notify people mid-run. Created by is set to the running agent.
Pick at least one user or role. Role membership is evaluated at send time; people who join the role later do not receive this notification.
Configure
| Setting | Description |
|---|---|
| Users | Workspace members to notify |
| Roles | Workspace roles whose holders are notified |
| Message | Body shown in the inbox (required). Liquid template rendered with the run context ({{ var }}) |
| Icon | Optional Font Awesome SVG from CDN (default bell) |
| Linked resource | Optional resource opened when the recipient clicks the row on web (agent, user, workflow, table, role, knowledge base, connected service, chat profile). On mobile, a table link opens that table; other types stay on the notifications list |
| Data | Optional JSON object stored with the notification |
Handles
| Handle | Role |
|---|---|
| In (target) | Incoming connection |
| Out (source) | Continues after the notification is sent |
Pipe schema
The next block reads this on the data pipe (pipe.value):
| Key | Type | Description |
|---|---|---|
id | text | Notification id |
recipientCount | number | How many people received a delivery |