Zoho logo

Get Lead by ID (Zoho CRM)

Zoho CRMGet Lead by ID (Zoho CRM)

POST/v1/zoho-get-lead-by-id
texau__zoho-get-lead-by-idcrm
cURL · api.texau.app
84ms
POST/v1/zoho-get-lead-by-id
{
  "lead_id": "sample-value"
}
200 Accepted
{
  "ok": true,
  "data": {
    "lead_id": "rec_4f3a91",
    "full_name": "sample",
    "first_name": "sample",
    "last_name": "sample",
    "company": "sample",
    "designation": "sample",
    "email": "[email protected]",
    "secondary_email": "[email protected]",
    "mobile_number": "sample",
    "fax": "sample",
    "website": "https://acme.com",
    "lead_source": "sample",
    "lead_status": "valid",
    "industry": "sample",
    "no_of_employee": 1,
    "annual_revenue": 1,
    "rating": "sample",
    "email_opt_out": "[email protected]",
    "skype_id": "rec_4f3a91",
    "twitter": "sample",
    "street": "sample",
    "city": "sample",
    "state": "sample",
    "zip_code": "sample",
    "country": 1,
    "description": "sample",
    "is_converted": true,
    "converted_account": 1,
    "converted_contact": "sample",
    "converted_deal": "sample",
    "converted_date_time": "sample",
    "owner_id": "rec_4f3a91",
    "owner_name": "sample",
    "created_by_id": "rec_4f3a91",
    "created_by_name": "sample",
    "modified_by_id": "rec_4f3a91",
    "modified_by_name": "sample",
    "created_time": "sample",
    "modified_time": "sample",
    "last_activity_time": "sample",
    "record_status": "valid",
    "is_locked": true
  }
}

Retrieve details of a specific lead using its unique Zoho Record ID.

Install

Add get lead by id (zoho crm) to your MCP client.

Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.

claude_desktop_config.json
{
  "mcpServers": {
    "texau": {
      "command": "npx",
      "args": ["-y", "@texau/mcp-server"],
      "env": { "TEXAU_API_KEY": "..." }
    }
  }
}

Tool name: texau__zoho-get-lead-by-id

When to use this.

The "Get Lead by ID" action in Zoho CRM allows users to retrieve detailed information about a specific lead using its unique Zoho Record ID. The primary input parameter is the "lead_id," which is a string representing the unique identifier of the lead. Upon execution, this action outputs a comprehensive set of fields, including the lead's full name, contact details (email, mobile number), company information, lead status, and conversion details, among others. The output fields encompass various semantic types such as id, text, email, phone, and date, providing a rich dataset for analysis. This action is particularly useful for sales and marketing teams looking to track lead progress, manage customer relationships, and analyze lead performance within the CRM ecosystem. It falls under the CRM category, making it an essential tool for effective customer relationship management.

Try it

Run a sample request.

The response is a deterministic, cached example. No live call, no credits used.

Get Lead by ID (Zoho CRM)

Try it

The unique Zoho Record ID of the lead to retrieve.

Response is cached — no live API call.

Response

Output schema.

Every field returned in `data`. Click rows to expand nested objects.

FieldType
  • lead_id
    Lead Id
    string
  • full_name
    Full Name
    nullablestring
  • first_name
    First Name
    string
  • last_name
    Last Name
    string
  • company
    Company
    string
  • designation
    Designation
    string
  • email
    Email
    string
  • secondary_email
    Secondary Email
    nullablestring
  • mobile_number
    Mobile Number
    string
  • fax
    Fax
    nullablestring
  • website
    Website
    string
  • lead_source
    Lead Source
    nullablestring
  • lead_status
    Lead Status
    nullablestring
  • industry
    Industry
    string
  • no_of_employee
    No Of Employee
    nullablenumber
  • annual_revenue
    Annual Revenue
    nullablenumber
  • rating
    Rating
    nullablestring
  • email_opt_out
    Email Opt Out
    nullableboolean
  • skype_id
    Skype Id
    nullablestring
  • twitter
    Twitter
    nullablestring
  • street
    Street
    nullablestring
  • city
    City
    string
  • state
    State
    nullablestring
  • zip_code
    Zip Code
    nullablestring
  • country
    Country
    string
  • description
    Description
    nullablestring
  • is_converted
    Is Converted
    nullableboolean
  • converted_account
    Converted Account
    nullablestring
  • converted_contact
    Converted Contact
    nullablestring
  • converted_deal
    Converted Deal
    nullablestring
  • converted_date_time
    Converted Date Time
    nullablestring
  • owner_id
    Owner Id
    nullablestring
  • owner_name
    Owner Name
    nullablestring
  • created_by_id
    Created By Id
    nullablestring
  • created_by_name
    Created By Name
    nullablestring
  • modified_by_id
    Modified By Id
    nullablestring
  • modified_by_name
    Modified By Name
    nullablestring
  • created_time
    Created Time
    nullablestring
  • modified_time
    Modified Time
    nullablestring
  • last_activity_time
    Last Activity Time
    nullablestring
  • record_status
    Record Status
    nullablestring
  • is_locked
    Is Locked
    nullableboolean

Integrate

Copy-pasteable snippets.

Real endpoint: https://v3-api.texau.com/api/v1/zoho-get-lead-by-id. Auth: x-api-key.

cURL · api.texau.app
84ms
POST/v1/zoho-get-lead-by-id
curl -X POST 'https://v3-api.texau.com/api/v1/zoho-get-lead-by-id' \
  -H 'x-api-key: $TEXAU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"lead_id":"sample-value"}'
200 Accepted
{
  "ok": true,
  "data": {
    "lead_id": "rec_4f3a91",
    "full_name": "sample",
    "first_name": "sample",
    "last_name": "sample",
    "company": "sample",
    "designation": "sample",
    "email": "[email protected]",
    "secondary_email": "[email protected]",
    "mobile_number": "sample",
    "fax": "sample",
    "website": "https://acme.com",
    "lead_source": "sample",
    "lead_status": "valid",
    "industry": "sample",
    "no_of_employee": 1,
    "annual_revenue": 1,
    "rating": "sample",
    "email_opt_out": "[email protected]",
    "skype_id": "rec_4f3a91",
    "twitter": "sample",
    "street": "sample",
    "city": "sample",
    "state": "sample",
    "zip_code": "sample",
    "country": 1,
    "description": "sample",
    "is_converted": true,
    "converted_account": 1,
    "converted_contact": "sample",
    "converted_deal": "sample",
    "converted_date_time": "sample",
    "owner_id": "rec_4f3a91",
    "owner_name": "sample",
    "created_by_id": "rec_4f3a91",
    "created_by_name": "sample",
    "modified_by_id": "rec_4f3a91",
    "modified_by_name": "sample",
    "created_time": "sample",
    "modified_time": "sample",
    "last_activity_time": "sample",
    "record_status": "valid",
    "is_locked": true
  }
}

Output

Results land in a TexAu table.

Sample rows below.

Real result preview coming soon.

InputStatusScore
[email protected]valid96
[email protected]risky54
[email protected]invalid12

Workflow

A real example.

Trigger → get lead by id (zoho crm) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.

Step 1TriggerNew row, webhook, or schedule.
Step 2Get Lead by ID (Zoho CRM)Zoho CRM action runs.
Step 3EnrichWaterfall fills missing fields.
Step 4Push to CRMHubSpot / Salesforce / Pipedrive.

Built for

Who runs this.

GTM EngineerRevOpsAgency

Reliability

Rate limits & reliability.

  • Per-minute limit100 / min
  • Per-day limit2,000 / day
  • RetriesAutomatic w/ backoff
  • ModeSync

Errors

HTTP status codes.

What each response means and what to do about it.

CodeCauseFix
200 OKAction ran. Data in `data`.Read response.
400 Bad RequestMissing or malformed input.Validate against the input schema.
401 UnauthorizedMissing or invalid `x-api-key`.Re-issue from /api-platform.
403 ForbiddenWorkspace lacks plan tier.Upgrade or contact sales.
404 Not FoundAction key not recognized.Verify the slug.
429 Rate LimitedPer-minute or per-day cap hit.Backoff; reduce concurrency.
500 Server ErrorUnexpected TexAu issue.Retry with backoff.
502 Bad GatewayUpstream provider 5xx.Retry; we surface root cause.
504 TimeoutUpstream slower than maxLatency.Switch to `isAsync` polling.

Pricing

What it costs to run.

Light tier

Pricing tier on /pricing. Per-action credit cost is private.

FAQ.

  • Is this real-time?

    Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).

  • Do I get charged on failure?

    No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.

  • Does it work with Claude / Cursor via MCP?

    Yes. Add the texau MCP server to your client config, then call `texau__zoho crm-...` directly.

  • What CRMs can I push results to?

    HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.

Run Get Lead by ID (Zoho CRM) in 60 seconds.

Pull your API key, paste the cURL, ship to your CRM.