Overview
This node integrates with the Taximail API to send transactional emails, SMS messages, and OTP (One-Time Password) SMS, as well as verify OTP codes and check message statuses. The "Send Email" operation allows users to send customized or templated emails by specifying recipient details, sender information, and email content or template keys.
Common scenarios for this node include:
- Sending notification or confirmation emails from applications.
- Dispatching marketing or transactional emails using predefined templates.
- Automating email communications in workflows where dynamic content or templates are used.
For example, a user can send a welcome email to a new customer by providing the recipient's email, sender's name and email, and either an HTML content body or a template key referencing a saved email template.
Properties
| Name | Meaning |
|---|---|
| To Email | Recipient email address where the email will be sent. |
| From Email | Sender's email address that appears as the source of the email. |
| From Name | Sender's display name shown in the email's "From" field. |
| Email Template Key | Optional key to use an existing email template instead of custom subject and HTML content. |
| Subject | Subject line of the email; not required if using an email template key. |
| HTML Content | HTML formatted content of the email; not required if using an email template key. |
Output
The node outputs a JSON object containing the response from the Taximail API along with some additional metadata:
operation: The string"email"indicating the performed operation.message_id: A unique identifier generated for the sent email message. This ID should be saved if the user wants to check delivery status later.note: A message prompting the user to save themessage_idfor future reference.- Other fields returned by the Taximail API response are included as-is in the output JSON.
The node does not output binary data.
Dependencies
- Requires an API authentication credential (HTTP Basic Auth) with username and password to access the Taximail API.
- The node uses the Taximail REST API endpoints for sending emails.
- No additional environment variables are explicitly required beyond the API credentials.
Troubleshooting
- Missing Required Fields: Ensure all required properties such as "To Email", "From Email", and "From Name" are provided when sending an email.
- Template Key Usage: If using an email template key, do not provide subject or HTML content as they are ignored.
- API Authentication Errors: Verify that the API credentials (username and password) are correct and have sufficient permissions.
- Operation Failures: If the node throws an error like "Operation failed", check the detailed error message returned by the API for issues such as invalid parameters or network problems.
- Unknown Operation: The node only supports specific operations; ensure "Send Email" is selected correctly.
Links and References
- Taximail API Documentation (for detailed API usage and templates)
- n8n Documentation on Creating Custom Nodes