zeptomail

The ZeptoMail skill enables AI agents to programmatically send transactional emails directly via the Zoho ZeptoMail API. Designed for developers and automated systems, this skill allows for reliable delivery of system-generated notifications, user verification codes, invoices, and marketing alerts without the overhead of heavy SDKs. By leveraging simple curl-based requests, the agent can integrate seamless email functionality into its workflows, handling complex requirements such as multi-part MIME attachments, inline images using Content-ID (CID), and detailed template management with merge fields.

• Support for basic text and rich HTML email composition for diverse communication needs.

• Advanced transactional features including open tracking, click tracking, and client reference tagging for CRM alignment.

• Efficient batch processing capability, allowing up to 500 recipients per API call with personalized merge data.

• Secure integration via API token authentication using the Zoho-enczapikey scheme, compliant with ZeptoMail security standards.

• Flexible attachment and inline image handling via Base64 encoding for professional invoices or visually rich newsletters.

• Templated email support with merge tags, perfect for personalized user journeys like onboarding, order confirmations, and monthly reports.

• The base URL for all operations is https://api.zeptomail.com/v1.1, requiring an active ZEPTOMAIL_TOKEN environment variable.

• For troubleshooting, agents should utilize the zero doctor command or verify endpoints against the ZeptoMail API documentation.

• Input payloads are expected as structured JSON files written to a temporary path, ensuring clean and audit-ready data flows.

• Ensure all email addresses and merge tags are correctly formatted before executing the POST request to avoid rejection by the mail gateway.

• Monitor email performance by inspecting tracking metrics and referencing the client_reference ID to link activity back to specific triggers.