n8n-nodes-llw-zoho

This is an n8n community node that lets you use Zoho Campaigns in your n8n workflows.

Zoho Campaigns is an email marketing automation platform that enables businesses to create, send, and track email campaigns.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Credentials Compatibility Usage Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Manual installation

To get started install the package in your n8n root directory:

npm install @aayshian/n8n-nodes-llw-zoho-ay19

For Docker-based deployments, add the following line before the font installation command in your n8n Dockerfile:

RUN cd /usr/local/lib/node_modules/n8n && npm install @aayshian/n8n-nodes-llw-zoho-ay19

Operations

Fetch Campaigns

• Retrieve all recent campaigns from your Zoho Campaigns account
• Returns complete campaign data including status, type, and metadata
• No filtering applied - returns raw API response for maximum flexibility
• Use downstream nodes to filter and process campaign data as needed

Send Campaign

• Send email campaigns directly from your workflow
• Dynamic dropdown shows only Draft and Scheduled campaigns (prevents accidental re-sends)
• Campaigns are sorted alphabetically for easy selection
• Triggers immediate campaign delivery to your mailing list

Credentials

This node uses Zoho OAuth 2.0 authentication with refresh token flow. You will need the following credentials:

• Client ID: Your Zoho OAuth Client ID
• Client Secret: Your Zoho OAuth Client Secret
• Refresh Token: Your Zoho OAuth Refresh Token
• Region: Your Zoho data center region (India, US, Europe, Australia, or China)

Getting Your Credentials

1. Go to Zoho API Console
2. Create a new client (Server-based Applications)
3. Generate your OAuth credentials
4. Use the authorization flow to obtain a refresh token
5. Enter your credentials in n8n's credential manager

Supported Regions

• India (in): accounts.zoho.in / campaigns.zoho.in
• US (com): accounts.zoho.com / campaigns.zoho.com
• Europe (eu): accounts.zoho.eu / campaigns.zoho.eu
• Australia (com.au): accounts.zoho.com.au / campaigns.zoho.com.au
• China (com.cn): accounts.zoho.com.cn / campaigns.zoho.com.cn

Compatibility

• Tested with n8n version 1.0.0 and above
• Minimum n8n version required: 0.200.0

Usage

Basic Workflow Example

Example: Automated Campaign Sending

Schedule Trigger → Zoho Campaigns (Fetch Campaigns)
                 → Code Node (Filter for specific campaign)
                 → Zoho Campaigns (Send Campaign)
                 → Email Notification (Confirmation)

Workflow Details

1. Fetch All Campaigns:

   • Add the Zoho Campaigns node
   • Select "Fetch Campaigns" operation
   • Execute to retrieve all recent campaigns
   • Use the raw response in downstream nodes for custom filtering

2. Send a Campaign:

   • Add the Zoho Campaigns node
   • Select "Send Campaign" operation
   • Choose a campaign from the dropdown (only Draft/Scheduled campaigns shown)
   • Execute to send immediately

Resources

• n8n community nodes documentation
• Zoho Campaigns API Documentation
• Zoho API Console

Development

Setup

1. Clone this repository
2. Install dependencies: yarn install
3. Build the node: yarn build
4. Link for local development: yarn link

Build

yarn build      # Build for production
yarn dev        # Watch mode for development

Lint

yarn lint       # Check for linting issues
yarn lintfix    # Auto-fix linting issues

Testing

yarn test                 # Run all tests
yarn test:watch          # Run tests in watch mode
yarn test:coverage       # Run tests with coverage report

See __tests__/README.md for detailed testing documentation.

Version History

• 1.0.1: Current stable release
• 1.0.0: Initial release with Fetch Campaigns and Send Campaign operations

Author

Tanish ([email protected])

License

MIT