Zoho CRM

Read and write Leads, Contacts, and Deals in Zoho CRM through the official Zoho CRM REST API v6.

• Base URL: https://www.zohoapis.com (override per data center via apiDomain)
• Auth: Authorization: Zoho-oauthtoken <access_token>
• Standard-library Python only (no external dependencies).

Operations

{module} is one of Leads, Contacts, Deals (defaults to Leads).

API key setup

1. Go to the Zoho API Console and create a client (Self Client is simplest for server-to-server use).
2. Generate an access token with a CRM scope such as ZohoCRM.modules.ALL (or a narrower ZohoCRM.modules.leads.{READ,CREATE,UPDATE}).
3. Pass that token as apiKey. It is sent as Authorization: Zoho-oauthtoken <token>.

Zoho access tokens expire roughly every hour. For unattended automation, use your refresh token to mint a fresh access token before each run (e.g. a preceding http task hitting https://accounts.zoho.com/oauth/v2/token), then feed the result into this tool's apiKey.

Data center

Pick apiDomain to match where your Zoho account lives:

Examples

List the 5 most recent leads

{
  "apiKey": "1000.xxxx.yyyy",
  "operation": "list_records",
  "module": "Leads",
  "perPage": "5"
}

Get one contact by id

{
  "apiKey": "1000.xxxx.yyyy",
  "operation": "get_record",
  "module": "Contacts",
  "recordId": "3652397000003852095"
}

Create a lead

{
  "apiKey": "1000.xxxx.yyyy",
  "operation": "insert_record",
  "module": "Leads",
  "fields": "{\"Last_Name\": \"Smith\", \"First_Name\": \"John\", \"Company\": \"ABC Corp\", \"Email\": \"[email protected]\"}"
}

Update a deal's stage

{
  "apiKey": "1000.xxxx.yyyy",
  "operation": "update_record",
  "module": "Deals",
  "recordId": "3652397000003852095",
  "fields": "{\"Stage\": \"Closed Won\", \"Amount\": 25000}"
}

Output

Every call publishes:

• result — the raw Zoho JSON response body (as a string).
• status — the HTTP status code (e.g. 200, 201, 401).

Non-2xx responses are returned with their body intact (not thrown) so the caller can inspect Zoho's error code. A transport-level failure emits {"error": "..."} and exits non-zero, marking the step FAILED.

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.