Zoho Campaigns

The Zoho Campaigns connector lets AI agents manage email campaigns, mailing lists, and subscriber data. It uses OAuth 2.0 so your credentials are stored encrypted in MCPGate's vault and are never exposed to the AI client.

Required scopes#

MCPGate requests the following OAuth scopes when you connect a Zoho Campaigns account.

Scope	Purpose
ZohoCampaigns.campaign.ALL	Read, create, and send email campaigns
ZohoCampaigns.contact.ALL	Manage subscribers and mailing lists

Tool reference#

The Zoho Campaigns connector exposes 10 tools. Use the MCP Apps page to enable or disable individual tools per app, and the Guardrails page to add fine-grained rules on top.

Tool	Category	Description
zohocampaigns_list_campaigns	read	List all campaigns in Zoho Campaigns
zohocampaigns_get_campaign	read	Get details of a specific Zoho Campaigns campaign by key
zohocampaigns_list_mailing_lists	read	List all mailing lists in Zoho Campaigns
zohocampaigns_list_subscribers	read	List subscribers in a Zoho Campaigns mailing list
zohocampaigns_get_report	read	Get campaign performance report from Zoho Campaigns
zohocampaigns_create_campaign	write	Create a new email campaign in Zoho Campaigns
zohocampaigns_send_campaign	write	Send or schedule an email campaign in Zoho Campaigns
zohocampaigns_add_subscriber	write	Add a subscriber to a Zoho Campaigns mailing list
zohocampaigns_update_subscriber	write	Update subscriber details in a Zoho Campaigns mailing list
zohocampaigns_unsubscribe	write	Unsubscribe a contact from a Zoho Campaigns mailing list

Sending a campaign is immediate

zohocampaigns_send_campaign dispatches the campaign to all subscribers in the target list immediately (or at the scheduled time). Always deny this tool in development apps and review the recipient list before enabling it in production.

Common guardrail recipes#

Read-only access#

Apply the read_only preset to enable the five read tools and deny all write tools. Suitable for marketing analytics agents that report on campaign performance metrics without modifying any lists or campaigns.

Manage contacts preset#

Use the manage_contacts preset to enable read tools plus zohocampaigns_add_subscriber and zohocampaigns_update_subscriber, while blocking campaign creation, sending, and unsubscribe. Useful for CRM sync agents that need to grow lists but should not trigger campaigns.

Full access#

The full_access preset enables all 10 tools. Apply a allow_values guardrail to zohocampaigns_send_campaign targeting the list_key field to restrict which mailing lists the agent is allowed to send to.

Troubleshooting#

Campaign key vs campaign name — Zoho Campaigns uses an internal campaign key (not the display name) for most API operations. Always retrieve the key from zohocampaigns_list_campaigns before passing it to other tools.
Unsubscribe compliance — zohocampaigns_unsubscribe marks the contact as opted-out globally. Zoho Campaigns will not allow re-subscribing such contacts via the API without a confirmed opt-in. Use with caution.
Bounce and spam errors — Campaigns fail to send if the account has unresolved bounce or spam-complaint issues. Check the Zoho Campaigns dashboard for deliverability alerts if zohocampaigns_send_campaign returns errors.