Overview
This node sends email notifications using the 97Display notification API. It supports sending emails either by selecting a predefined email template or by manually specifying the subject and body content. The node is useful in workflows where automated email communication is required, such as sending confirmation emails, alerts, or newsletters triggered by events captured via webhooks.
Practical examples:
- Sending a welcome email to new users after they sign up.
- Dispatching alert notifications to team members when certain conditions are met.
- Using predefined templates for consistent branding and messaging across emails.
Properties
| Name | Meaning |
|---|---|
| Organization ID | Hidden field automatically populated from webhook data; identifies the organization context. |
| Workflow ID | Hidden field set to the current workflow's ID; used internally for tracking and API requests. |
| Use Email Template? | Boolean toggle to choose between using a predefined email template or manual entry of subject and body. |
| Email Template | Dropdown list of available email templates loaded dynamically from the API; shown only if "Use Email Template?" is true. |
| Subject | Text input for the email subject; required if not using an email template. |
| Body | Text area for the email body content; required if not using an email template. |
| Is HTML Email | Hidden boolean indicating whether the email should be sent as HTML (false means plain text). |
| APIKey | Hidden field that takes the API key from environment variables; used for authenticating API requests. |
Output
The node outputs an array of JSON objects, each representing the response from the 97Display notification API for each email sent. Each output item contains the full JSON response returned by the API, which typically includes status information about the email dispatch.
No binary data is produced by this node.
Dependencies
- Requires access to the 97Display notification API endpoint at
https://notificationapi.api97.com. - Needs a valid API key credential provided via environment variable for authentication.
- The node dynamically loads available email templates from the API based on the current workflow ID.
- Relies on webhook input data containing recipient details and tokens for personalization.
Troubleshooting
Common issues:
- Failure to load email templates: This can occur if the API key is invalid or the workflow ID is incorrect.
- Email sending errors: May happen if required fields like recipient email or template ID are missing or malformed.
- Parsing errors when using templates: If the selected template JSON is corrupted or improperly formatted.
Error messages and resolutions:
"Error loading templates: <message>": Check API key validity and network connectivity.- API request failures with authentication errors: Verify the API key environment variable is correctly set.
- JSON parsing exceptions: Ensure the email template option value is a valid JSON string or a correct template ID.
Links and References
- 97Display Notification API Documentation (assumed official API docs)
- n8n documentation on Creating Custom Nodes