productivity
Zoho CRM CLI for Cron Jobs
Use the Zoho CRM CLI for cron jobs with headless JSON commands, schema discovery, credentials, and permission controls.
15 functions 9 read 6 write Manual OAuth token auth
Zoho CRM CLI for Cron Jobs
Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config.
Use the headless CLI from cron when an operation should run without an interactive agent session. 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 Cron Jobs
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.