# Zoho Campaign MCP > Zoho Campaign connects your AI agent directly to Zoho Campaigns, letting you manage entire email marketing workflows by conversation. You can create new campaigns, build targeted mailing lists, segment contacts, import large contact batches, and pull detailed performance reports—all without touching the web interface. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** campaign-management, mailing-lists, email-analytics, audience-segmentation, lead-nurturing, open-rates ## Description Managing a successful email campaign used to mean logging into a dashboard and clicking through half a dozen tabs just to get the data you needed. Now, your agent handles that whole process. This MCP lets you automate every step of your marketing outreach in Zoho Campaigns. You can ask it to build an entire sequence: first, create a new mailing list; second, import hundreds of contacts into that list; and finally, schedule and send a campaign with a specific subject line. The system tracks everything—from basic metrics like opens and clicks to detailed subscriber status. Because this MCP is hosted on Vinkius, you get access to all these functions through one single connection point from any compatible AI client. It’s built for marketing teams that need constant visibility into their audience health, campaign performance, and overall contact management. ## Tools ### add_contacts_to_list Adds multiple contacts, providing email addresses and optional details, to a specified mailing list. ### create_campaign Sets up an entirely new email campaign within Zoho Campaign with all required sender and subject information. ### create_list Establishes a brand-new mailing list, optionally setting up its initial welcome message. ### get_blocked_contacts Retrieves details about contacts that have bounced or been blocked to keep your lists clean. ### get_campaign_details Shows the full configuration and settings for a specific, existing email campaign. ### get_campaign_report Provides an in-depth analytics report on a finished campaign, listing opens, clicks, bounces, etc. ### get_campaigns Lists every existing email campaign to give you a high-level overview of your publishing portfolio. ### get_contact Fetches specific profile details for one subscriber, useful for troubleshooting or deep dives. ### get_list_contacts Retrieves a list of all contacts within a given mailing list, including their subscription status and name. ### get_lists Lists every available mailing list, showing its contact count and creation date. ### get_recent_campaigns Quickly pulls a summary of the most recently created or sent campaigns for an activity check. ### remove_contacts_from_list Removes specific contacts from a mailing list, managing unsubscribes or cleaning up segments. ### update_contact Modifies existing contact details like names or company information using the email address as identification. ## Prompt Examples **Prompt:** ``` Show me all campaigns sent in the last 30 days with their open rates ``` **Response:** ``` I'll pull your recent campaigns and compile the open rate metrics for you. ``` **Prompt:** ``` Create a new campaign called 'Spring Sale 2026' for our newsletter list with subject 'Exclusive Spring Discounts Inside' ``` **Response:** ``` I'll create the Spring Sale campaign configured for your newsletter mailing list. ``` **Prompt:** ``` Add these 50 contacts from my CRM export to the 'Prospects Q2' list ``` **Response:** ``` I'll import the contacts into your Prospects Q2 mailing list right away. ``` ## Capabilities ### Manage mailing lists Create new subscriber lists or list all existing ones to organize your audience segments. ### Control campaigns Build and schedule full email campaigns with specific subject lines, senders, and content templates. ### Handle contacts at scale Add bulk groups of new contacts to a list or remove subscribers who need to be unsubscribed. ### Review performance data Pull comprehensive analytics reports on sent campaigns, including total opens, clicks, bounces, and complaints. ## Use Cases ### Cleaning up a stale mailing list A marketing ops engineer notices the 'Q1 Leads' list hasn't been active in months. They ask their agent to use `get_blocked_contacts` and then run `remove_contacts_from_list` on anyone who bounced last quarter, ensuring future campaigns aren't wasted. ### Launching a product update sequence A product manager needs to launch a major announcement. They ask their agent to first use `create_list` for the 'VIP Beta Testers,' then populate it with 50 key users via `add_contacts_to_list`, and finally run `create_campaign` using the new list. ### Analyzing campaign success after Q4 A marketing director wants to know if the holiday sale worked. They ask their agent for a full report, triggering `get_campaign_report` on the 'Holiday Sale' campaign and getting instant metrics on engagement rates. ### Updating contact roles post-acquisition After buying a new company, the team needs to update role titles for 200 contacts. They use `get_list_contacts` to pull the current list and then instruct their agent to run `update_contact` on all users with specific email patterns. ## Benefits - Never manually compile reports again. You get an instant breakdown of campaign ROI—opens, clicks, bounces, and complaints—using `get_campaign_report`. - Keep your audience clean automatically. Run the `get_blocked_contacts` tool to identify invalid email addresses before sending any batch update. - Segmenting contacts is fast. Instead of filtering through spreadsheets, you can use `get_list_contacts` and ask your agent to narrow down users based on their subscription status. - Build campaigns in minutes. Use the `create_campaign` tool to deploy a full email sequence, specifying the subject line, sender details, and even scheduling. - Maintain list integrity by controlling who belongs where. You can use `remove_contacts_from_list` to manage unsubscribes or clean out old leads without manual intervention. ## How It Works The bottom line is, you talk to your agent like you're talking to an intern who already knows how to use Zoho Campaigns. 1. You authorize your AI client to access Zoho Campaigns via an OAuth token. 2. You give a natural language command: 'Create a campaign called X for the Y list.' 3. The MCP executes the complex API sequence and returns formatted data showing success or failure. ## Frequently Asked Questions **How do I check if my contact list has bad emails using the Zoho Campaign MCP?** Use `get_blocked_contacts` to retrieve a list of contacts that have bounced or been blocked. This helps you proactively clean your mailing lists and maintain high deliverability scores. **What is the best way to segment my subscribers with Zoho Campaign MCP?** First, use `get_list_contacts` to see everyone's status. Then, instruct your agent to pull a subset of users who match specific criteria, like those who haven't opened an email in 60 days. **Can I create a campaign using the Zoho Campaign MCP?** Yes, you can use `create_campaign` to build and schedule a new email. Just provide the required details: the name, subject line, sender information, and if it needs scheduling. **How many campaigns can I view using the Zoho Campaign MCP?** You can list all of them by calling `get_campaigns`. This gives you a quick overview of your entire campaign history and status in one place. **What if I need to add 100 new leads to my mailing list?** Use the `add_contacts_to_list` tool. You provide the contacts as a JSON array, including their emails and any custom details you have, and it adds them in bulk.