---
title: Zoho lead
description: Perform CRUD operations on Zoho Lead records within your workflow.
category: Application
tags: [zoho, lead, crm, integration]
---

# Zoho lead

## Description

The **Zoho Lead** entity represents potential customers or contacts captured through marketing or sales outreach. Each lead includes information such as name, company, contact details, and lead status. It is the starting point for customer conversion in Zoho CRM.

The **Zoho Lead** activity enables workflows to perform operations like retrieving, creating, updating, or deleting lead records in Zoho CRM. It supports both single and bulk operations, making it suitable for lead automation and enrichment pipelines.

Use this activity to:

- Get – Retrieve a single lead by ID
- Get All – Retrieve all leads
- Create – Add a new lead record
- Create Many – Add multiple lead records using field mappings
- Update – Modify an existing lead record
- Delete – Delete a lead by ID

> **Use case**:

## Input

- **Data** – Required only for Create Many, and Update operations.

## Output

| Output Type | Format | Description                |
| ----------- | ------ | -------------------------- |
| **Data**    | JSON   | Zoho lead record(s) output |

## Configuration Fields

| Field Name         | Description                                                                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connection**     | Select a Zoho connection (OAuth). Required for authentication.                                                                                 |
| **Operation**      | Select one of the supported operations: <ul><li>Get</li><li>Get All</li><li>Create</li><li>Create Many</li><li>Update</li><li>Delete</li></ul> |
| **Id**             | Used in `Get`, `Update`, and `Delete`. Provide the Zoho Lead ID.                                                                               |
| **Fields**         | Used in `Create` and `Update`. Define values like `Company`, `First Name`, `Last Name`, `Email`, etc.                                          |
| **Fields Mapping** | Used in `Create Many`. Maps fields from input data to Zoho fields.                                                                             |

## Sample Input

| Operation       | Required Fields | Example Input                                                                                              |
| --------------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
| **Get**         | `Id`            | <table><tr><td>Id</td><td>1234567000000302011</td></tr></table>                                            |
| **Get All**     | _None_          | _(No input required)_                                                                                      |
| **Create**      | Lead fields     | <table><tr><td>Company</td><td>Acme Corp</td></tr><tr><td>Email</td><td>lead@example.com</td></tr></table> |
| **Update**      | `Id`, `Fields`  | <table><tr><td>Id</td><td>1234567000000302011</td></tr><tr><td>Status</td><td>Contacted</td></tr></table>  |
| **Delete**      | `Id`            | <table><tr><td>Id</td><td>1234567000000302011</td></tr></table>                                            |
| **Create Many** | Field Mapping   | <table><tr><td>Company</td><td>[OrgName]</td></tr><tr><td>Email</td><td>[WorkEmail]</td></tr></table>      |

> Input fields for **Create Many** operation are mapped from data output by the previous activity in the workflow.

## Sample Configuration

| Field             | Value                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------- |
| `connection.id`   | `zoho-prod-002`                                                                             |
| `connection.name` | `Zoho CRM Lead Sync`                                                                        |
| `operation`       | `CreateMany`                                                                                |
| `fieldsMapping`   | <ul><li>Company → OrgName</li><li>Email → WorkEmail</li><li>Phone → ContactNumber</li></ul> |

## Sample Output

| Id                | Company   | Email          | Status    | Created Time         |
| ----------------- | --------- | -------------- | --------- | -------------------- |
| 12345670000000001 | Acme Corp | lead@acme.com  | New Lead  | 2024-05-10T10:00:00Z |
| 12345670000000002 | Beta Inc. | sales@beta.com | Contacted | 2024-05-11T12:30:00Z |

---