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.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.