productivity
Zoho CRM CLI for Headless Automation
Use the Zoho CRM CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
15 functions 9 read 6 write Manual OAuth token auth
Zoho CRM CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Zoho CRM CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Zoho CRM CLI for Headless Automation
kosmokrator integrations:configure zoho_crm --set access_token="$ZOHO_CRM_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call zoho_crm.zoho_crm_create_lead '{"first_name":"example_first_name","last_name":"example_last_name","company":"example_company","email":"example_email","phone":"example_phone"}' --json Discovery Before Execution
Agents and scripts can inspect Zoho CRM docs and schemas before choosing a function.
kosmo integrations:docs zoho_crm --json
kosmo integrations:docs zoho_crm.zoho_crm_create_lead --json
kosmo integrations:schema zoho_crm.zoho_crm_create_lead --json
kosmo integrations:search "Zoho CRM" --json
kosmo integrations:list --json Useful Zoho CRM CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
zoho_crm.zoho_crm_create_lead | Write | first_name, last_name, company, email, phone | Create a new lead in Zoho CRM. Provide at least a last name or company name. Other fields (first name, email, phone) are optional. Returns the created lead with its Zoho CRM ID. |
zoho_crm.zoho_crm_get_lead | Read | lead_id | Retrieve a Zoho CRM lead by its ID. Returns the lead record with all populated fields. |
zoho_crm.zoho_crm_update_lead | Write | lead_id, first_name, last_name, company, email, phone | Update an existing lead in Zoho CRM. Provide the lead ID and the fields to update (first_name, last_name, company, email, phone). Returns the update status and modified lead details. |
zoho_crm.zoho_crm_search_leads | Read | criteria, email | Search Zoho CRM leads by criteria or email. Use "criteria" for structured queries like (Email:equals:[email protected]). Use "email" as a shortcut to search by email address. Returns matching lead records. |
zoho_crm.zoho_crm_create_contact | Write | first_name, last_name, email, phone | Create a new contact in Zoho CRM. Provide at least a last name. Other fields (first name, email, phone) are optional. Returns the created contact with its Zoho CRM ID. |
zoho_crm.zoho_crm_get_contact | Read | contact_id | Retrieve a Zoho CRM contact by its ID. Returns the contact record with all populated fields. |
zoho_crm.zoho_crm_update_contact | Write | contact_id, first_name, last_name, email, phone | Update an existing contact in Zoho CRM. Provide the contact ID and the fields to update (first_name, last_name, email, phone). Returns the update status and modified contact details. |
zoho_crm.zoho_crm_search_contacts | Read | criteria, email | Search Zoho CRM contacts by criteria or email. Use "criteria" for structured queries like (Email:equals:[email protected]). Use "email" as a shortcut to search by email address. Returns matching contact records. |
zoho_crm.zoho_crm_create_account | Write | account_name, website, phone, industry | Create a new account (organization) in Zoho CRM. Provide at least an account name. Other fields (website, phone, industry) are optional. Returns the created account with its Zoho CRM ID. |
zoho_crm.zoho_crm_get_account | Read | account_id | Retrieve a Zoho CRM account by its ID. Returns the account record with all populated fields. |
zoho_crm.zoho_crm_create_deal | Write | deal_name, amount, stage, closing_date, account_id | Create a new deal (opportunity) in Zoho CRM. Provide at least a deal name and stage. Other fields (amount, closing_date, account_id) are optional. Returns the created deal with its Zoho CRM ID. |
zoho_crm.zoho_crm_get_deal | Read | deal_id | Retrieve a Zoho CRM deal by its ID. Returns the deal record with all populated fields. |
zoho_crm.zoho_crm_list_deals | Read | page, per_page | List deals from Zoho CRM with optional pagination. Use page and per_page to control pagination. Returns deal records. |
zoho_crm.zoho_crm_list_users | Read | type, page | List users from Zoho CRM. Optionally filter by user type (e.g. ActiveUsers, Admins) and paginate results. |
zoho_crm.zoho_crm_get_current_user | Read | none | Retrieve the currently authenticated Zoho CRM user's profile. Returns user details including name, email, role, and other profile information. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.