View as Markdown
Zoho CRM icon

Zoho CRM ACTION

Convert Lead

Converts a Lead into a Contact or an Account. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Zoho CRM account once, then configure and run Convert Lead from your backend or agent.

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_crm-convert-lead",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    zoho_crm: { authProvisionId: "apn_xxxxxxx" },
    lead: "Lead",
    account: "Account",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Convert Lead inputs
Property Type Description
lead Lead string
Unique identifier of the lead record to be converted
Required Dynamic
account Account string
Use this key to associate an account with the lead being converted. Pass the unique and valid account ID.
Optional Dynamic
contact Contact string
Use this key to associate a contact with the lead being converted. Pass the unique and valid contact ID.
Optional Dynamic
user User string
Use this key to assign record owner for the new contact and account. Pass the unique and valid user ID.
Optional Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
zoho_crm-convert-lead
Version
0.1.3
App
Zoho CRM
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes