Zoho Campaigns icon

CONNECT APP

Build with Zoho Campaigns

Marketing platform built exclusively for email marketing—you bring in and manage the email database of your leads and contacts and send marketing emails to them.

Marketing

  • OAuth

MCP

Give your agent Zoho Campaigns tools

Every Zoho Campaigns action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Zoho Campaigns account for each tool call — you store no tokens.

// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": "{project_id}",
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "zoho_campaigns",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Contact to Mailing List:
const result = await mcp.callTool({
  name: "zoho_campaigns-add-contact-to-mailing-list",
  arguments: {
    listkey: "Mailing List",
    contactEmail: "Contact Email",
  },
})

API PROXY

Call the Zoho Campaigns API directly

For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Zoho Campaigns API with the connected user's credentials attached. You store no tokens and write no refresh logic.

const resp = await pd.proxy.get({
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  accountId: "apn_xxxxxxx",
  url: "https://api.example.com/v1/me",
})

// Any allowed Zoho Campaigns endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.

SDK

Run Zoho Campaigns actions from your backend

Connect a user's Zoho Campaigns account once, then run Add Contact to Mailing List on their behalf from your own code — TypeScript, Python, or plain HTTP.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "zoho_campaigns-add-contact-to-mailing-list",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    zoho_campaigns: { authProvisionId: "apn_xxxxxxx" },
    listkey: "Mailing List",
    contactEmail: "Contact Email",
  },
})

REFERENCE

App details

Reference metadata for the Zoho Campaigns connector in the Pipedream registry.

App slug
zoho_campaigns
Authentication
OAuth
Categories
Marketing
Actions
4
Triggers
2
API proxy
Available

OAuth scopes

These are the scopes Pipedream's managed Zoho Campaigns OAuth client requests when one of your users connects an account. Supply your own OAuth client to request a different set.

  • ZohoCampaigns.campaign.READ
  • ZohoCampaigns.campaign.CREATE
  • ZohoCampaigns.campaign.UPDATE
  • ZohoCampaigns.contact.CREATE
  • ZohoCampaigns.contact.UPDATE
  • ZohoCampaigns.contact.READ
  • ZohoCampaigns.userinfo.READ