Zoho Zeptomail icon

Zoho Zeptomail

Consume Zoho ZeptoMail API

Actions2

Overview

This node integrates with the Zoho ZeptoMail API to send emails programmatically. It supports sending plain or HTML emails as well as template-based emails using predefined templates in Zoho ZeptoMail. This node is useful for automating email notifications, marketing campaigns, transactional emails, or any scenario where sending emails dynamically from workflows is required.

For example, you can use this node to:

  • Send a custom notification email when a new user signs up.
  • Dispatch templated newsletters to multiple recipients.
  • Attach files and send reports automatically via email.

Properties

Name Meaning
Mail Agent Select the mail agent (email sending service) configured in Zoho ZeptoMail to send the email.
From Collection containing:
- From Address: The sender's email address belonging to the selected mail agent's domain.
- From Name: The display name of the sender.
To Comma-separated list of recipient email addresses.
Subject Subject line of the email (required for sending normal emails).
Body Content of the email in HTML format (optional).
Reply To Email address to be used as the reply-to address.
CC Comma-separated list of email addresses to be added as CC recipients.
BCC Comma-separated list of email addresses to be added as BCC recipients.
Attachments Collection containing:
- Content: Base64 encoded content of the attachment file.
- File Name: Name of the attachment file.
- Mime Type: MIME type of the attachment (e.g., plain/text, image/jpg).

Output

The node outputs JSON data representing the response from the Zoho ZeptoMail API after attempting to send the email. The structure typically includes details about the success or failure of the email sending operation.

If an error occurs and "Continue On Fail" is enabled, the output will include an error object with the message describing the failure.

No binary data output is produced by this node.

Dependencies

  • Requires an API authentication token credential for Zoho ZeptoMail (configured in n8n credentials).
  • Depends on the Zoho ZeptoMail API being accessible and properly configured with valid mail agents and templates.
  • Uses internal helper functions to format recipient addresses and make authenticated API requests.

Troubleshooting

  • Common issues:

    • Invalid or missing mail agent key: Ensure the selected mail agent exists and is correctly configured in Zoho ZeptoMail.
    • Incorrect "From" email address: The "From" address must belong to the domain associated with the chosen mail agent.
    • Malformed recipient addresses: Make sure all email addresses in To, CC, BCC, and Reply To fields are valid and comma-separated.
    • Attachment encoding errors: Attachments must be base64 encoded; otherwise, the API may reject them.

  • Error messages:

    • API errors returned from Zoho ZeptoMail usually contain detailed messages in the details[0].message field. These should be reviewed to correct input parameters.
    • Network or authentication failures indicate issues with API credentials or connectivity.

  • Resolution tips:

    • Verify API credentials and permissions.
    • Double-check email addresses and formatting.
    • Confirm that attachments are properly base64 encoded.
    • Use the "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

Discussion