Notification
Category: Integration
Node id: notification
Sends notifications via email (SMTP), SMS (platform messaging carrier), Slack or webhook. Push is not available.
What it does
- Delivery over email (SMTP connector), SMS (platform messaging carrier), Slack and webhook; push fails explicitly
- Priority levels: low, medium, high, urgent
- Configurable retry logic with count and delay
- Slack Block Kit support for rich message formatting
- Unique notification ID generation for tracking
- Channel-specific configuration (SMTP, sender number, Slack/webhook URL)
Use cases
- Send Slack alerts when a pipeline detects a critical condition
- Notify on-call staff via SMS for urgent healthcare events
- Email stakeholders when batch data processing completes
- Push notifications to mobile apps for patient status updates
- Webhook callbacks to external systems for event-driven architectures
Runtime
- Performance tier:
variable
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
recipient | text | Yes | Notification recipient (email, phone, channel, URL, or device token) |
message | text | Yes | Notification message body |
subject | text | No | Notification subject (for email and push) |
metadata | json | No | Additional metadata to include with the notification |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | Notification delivery summary with id, channel, recipient, status, priority, and sent_at |
success | boolean | No | Whether the notification was sent successfully |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Channel | channel | enum | Yes | email | email, sms, slack, webhook, push | Notification delivery channel |
| Priority | priority | enum | No | medium | low, medium, high, urgent | Notification priority level |
Auth
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| SMTP Host | smtp_host | string | No | SMTP server for email channel | ||
| SMTP Port | smtp_port | number | No | 587 | SMTP port for email channel | |
| SMTP User | smtp_user | string | No | SMTP username for email channel | ||
| SMTP Password | smtp_password | secret | No | SMTP password for email channel | ||
| From Address | from_address | string | No | Sender address for email channel | ||
| SMTP TLS Mode | smtp_tls_mode | enum | No | starttls | starttls, tls, none | Transport security for email |
| SMS Provider | sms_provider | enum | No | twilio | twilio | Ignored: SMS goes through the platform's messaging carrier |
| SMS API Key | sms_api_key | secret | No | Ignored: carrier credentials are platform configuration | ||
| From Number | from_number | string | No | Sender number for SMS; must belong to the organization. Empty uses the organization's default sender | ||
| Slack Webhook URL | slack_webhook_url | secret | No | Slack incoming webhook URL | ||
| Webhook URL | webhook_url | string | No | Target URL for webhook channel | ||
| Webhook Method | webhook_method | enum | No | POST | POST, PUT | HTTP method for webhook |
| Push Provider | push_provider | enum | No | fcm | fcm | Not available: the push channel always fails |
| Push API Key | push_api_key | secret | No | Not available: the push channel always fails |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Retry Count | retry_count | number | No | 3 | min 0; max 10 | Number of retry attempts |
| Retry Delay (ms) | retry_delay_ms | number | No | 1000 | min 0 | Delay between retries in milliseconds |
| Webhook Headers | headers | json | No | Custom HTTP headers for webhook notifications |
Errors
| Code | Description |
|---|---|
MISSING_RECIPIENT | Recipient input is required but was not provided |
MISSING_MESSAGE | Message input is required but was not provided |
UNSUPPORTED_CHANNEL | Notification channel is not one of: email, sms, slack, webhook, push |
DELIVERY_FAILED | Notification delivery failed after all retry attempts |
CHANNEL_CONFIG_MISSING | Required configuration for the selected channel is missing |
Runtime notes
- On failure after all retries, the node returns the result with status='failed' AND returns an error
- success is true only when status='sent'; downstream nodes should check both
- Each notification gets a unique ID (notif_<timestamp>_<seq>) for tracking; SMS adds the carrier's provider_message_id
- A channel that cannot deliver fails: SMS without a configured carrier, and push (no provider), never report success
- Retry logic sleeps between attempts; total latency = retry_count * retry_delay_ms in worst case
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..