Create Lead (Zoho CRM)
Zoho CRM → Create Lead (Zoho CRM)
/v1/zoho-create-lead{ "company": "Acme, Inc.", "last_name": "Doe", "first_name": "Jane", "title": "sample-value", "email": "[email protected]", "secondary_email": "[email protected]", "mobile_number": "sample-value", "fax": "sample-value", "website": "https://acme.com", "lead_source": "sample-value", "lead_status": "sample-value", "industry": "sample-value", "number_of_employee": 1, "annual_revenue": 1, "rating": "sample-value", "skype_id": "sample-value", "twitter": "sample-value", "street": "sample-value", "city": "sample-value", "state": "sample-value", "zip_code": "sample-value", "country": "sample-value", "description": "sample-value" }
{ "ok": true, "data": { "lead_id": "rec_4f3a91", "status": "valid", "message": "sample", "created_time": "sample" } }
Create a new lead record in Zoho CRM
Install
Add create lead (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.
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__zoho-create-lead
When to use this.
The "Create Lead (Zoho CRM)" action enables users to efficiently create new lead records within Zoho CRM, facilitating streamlined customer relationship management. This action requires two mandatory input parameters: the company name and the last name of the lead, ensuring essential identification for each lead. Additional optional parameters, such as first name, email, mobile number, and lead source, allow for comprehensive lead profiling. Upon execution, the action returns key output fields, including lead ID, status, message, and created time, providing immediate feedback on the lead creation process. This action is particularly useful for sales teams looking to manage leads effectively, track potential customers, and enhance overall sales strategies within the CRM category. By leveraging this API action, businesses can optimize their lead generation efforts and improve customer engagement.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Create Lead (Zoho CRM)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
lead_idLead IdstringstatusStatusnullablestringmessageMessagenullablestringcreated_timeCreated Timenullablestring
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/zoho-create-lead. Auth: x-api-key.
/v1/zoho-create-leadcurl -X POST 'https://v3-api.texau.com/api/v1/zoho-create-lead' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"company":"Acme, Inc.","last_name":"Doe","first_name":"Jane","title":"sample-value","email":"[email protected]","secondary_email":"[email protected]","mobile_number":"sample-value","fax":"sample-value","website":"https://acme.com","lead_source":"sample-value","lead_status":"sample-value","industry":"sample-value","number_of_employee":1,"annual_revenue":1,"rating":"sample-value","skype_id":"sample-value","twitter":"sample-value","street":"sample-value","city":"sample-value","state":"sample-value","zip_code":"sample-value","country":"sample-value","description":"sample-value"}'
{ "ok": true, "data": { "lead_id": "rec_4f3a91", "status": "valid", "message": "sample", "created_time": "sample" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
crm
Get Account by ID (Zoho CRM)
Retrieve details of a specific account using its unique Zoho Record ID.
crm
Delete Account (Zoho CRM)
Delete an existing account record in Zoho CRM using its unique record ID. This action typically moves the record to the Recycle Bin.
crm
List Contacts (Zoho CRM)
Retrieve a paginated list of contacts from Zoho CRM, including basic contact fields and pagination info.
Output
Results land in a TexAu table.
Sample rows below.
Real result preview coming soon.
| Input | Status | Score |
|---|---|---|
| [email protected] | valid | 96 |
| [email protected] | risky | 54 |
| [email protected] | invalid | 12 |
Workflow
A real example.
Trigger → create lead (zoho crm) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Built for
Who runs this.
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.
| Code | Cause | Fix |
|---|---|---|
| 200 OK | Action ran. Data in `data`. | Read response. |
| 400 Bad Request | Missing or malformed input. | Validate against the input schema. |
| 401 Unauthorized | Missing or invalid `x-api-key`. | Re-issue from /api-platform. |
| 403 Forbidden | Workspace lacks plan tier. | Upgrade or contact sales. |
| 404 Not Found | Action key not recognized. | Verify the slug. |
| 429 Rate Limited | Per-minute or per-day cap hit. | Backoff; reduce concurrency. |
| 500 Server Error | Unexpected TexAu issue. | Retry with backoff. |
| 502 Bad Gateway | Upstream provider 5xx. | Retry; we surface root cause. |
| 504 Timeout | Upstream slower than maxLatency. | Switch to `isAsync` polling. |
Related
More Zoho CRM actions.
crm
Get Account by ID (Zoho CRM)
Retrieve details of a specific account using its unique Zoho Record ID.
crm
Delete Account (Zoho CRM)
Delete an existing account record in Zoho CRM using its unique record ID. This action typically moves the record to the Recycle Bin.
crm
List Contacts (Zoho CRM)
Retrieve a paginated list of contacts from Zoho CRM, including basic contact fields and pagination info.
crm
Create Account (Zoho CRM)
Create a new account record in Zoho CRM, including company details, billing, and shipping addresses. Requires an Account Name.
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 Create Lead (Zoho CRM) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.