Overview
This node, named "Simple Email," allows users to send basic emails via an external email API service. It is designed for straightforward email sending tasks where you specify the recipient, subject, and body of the email. The node is useful in automation workflows that require notification emails, alerts, or simple communication without complex formatting or attachments.
Typical use cases include:
- Sending confirmation or alert emails after a workflow event.
- Notifying team members about process completions or errors.
- Dispatching simple transactional emails from automated processes.
Properties
| Name | Meaning |
|---|---|
| To Email | Recipient email address (required). |
| Subject | Subject line of the email (required). |
| Body | Plain text content of the email body (required). |
| Additional Fields | Optional extra fields; currently supports: |
| - From Email | Sender's email address. Defaults to "no-reply@example.com" if not specified. |
Output
The node outputs JSON data representing the response from the email sending API. On success, it returns an object indicating success (the exact structure depends on the API response but typically includes status information). If an error occurs, the output contains an error message describing what went wrong.
No binary data is produced by this node.
Example successful output JSON:
[
{
"success": true
}
]
Example error output JSON (if continue on fail is enabled):
[
{
"error": "Error message here"
}
]
Dependencies
- Requires an API key credential for the external email sending service (SendGrid API).
- The node makes HTTP POST requests to
https://api.sendgrid.com/v3/mail/send. - The user must configure the node with valid API credentials to authenticate requests.
- No additional environment variables are explicitly required beyond the API key credential.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication failures.
- Incorrectly formatted email addresses may result in API errors.
- Network connectivity problems can prevent the request from completing.
- Missing required parameters (
to,subject, orbody) will cause validation errors.
Error messages:
- Errors returned from the API are captured and can be output if "Continue On Fail" is enabled.
- Typical error messages might include authentication errors, invalid recipient addresses, or rate limiting notices.
Resolution tips:
- Verify the API key is correctly set up and has permissions to send emails.
- Ensure all required fields are filled with valid values.
- Check network access to the SendGrid API endpoint.
- Use the node’s "Continue On Fail" option to handle errors gracefully within workflows.