KosmoKrator

accounting

Zoho Books CLI for Cron Jobs

Use the Zoho Books CLI for cron jobs with headless JSON commands, schema discovery, credentials, and permission controls.

12 functions 7 read 5 write Manual OAuth token auth
Submit Zoho Books feedback View package source

Zoho Books 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 Books CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Zoho Books CLI for Cron Jobs
kosmokrator integrations:configure zoho_books --set access_token="$ZOHO_BOOKS_ACCESS_TOKEN" --set organization_id="$ZOHO_BOOKS_ORGANIZATION_ID" --enable --read allow --write ask --json
kosmo integrations:call zoho_books.zohobooks_list_invoices '{"status":"example_status","customer_id":"example_customer_id","date_start":"example_date_start","date_end":"example_date_end","page":1,"per_page":1,"search_text":"example_search_text"}' --json

Discovery Before Execution

Agents and scripts can inspect Zoho Books docs and schemas before choosing a function.

kosmo integrations:docs zoho_books --json
kosmo integrations:docs zoho_books.zohobooks_list_invoices --json
kosmo integrations:schema zoho_books.zohobooks_list_invoices --json
kosmo integrations:search "Zoho Books" --json
kosmo integrations:list --json

Useful Zoho Books CLI Functions

FunctionTypeParametersDescription
zoho_books.zohobooks_list_invoices Read status, customer_id, date_start, date_end, page, per_page, search_text List invoices from Zoho Books. Returns a paginated list of invoices with optional filters for status, customer, and date range.
zoho_books.zohobooks_get_invoice Read invoice_id Get full details of a specific invoice in Zoho Books by its ID, including line items, totals, payments, and credits.
zoho_books.zohobooks_create_invoice Write customer_id, line_items, date, due_date, invoice_number, reference_number, notes, terms Create a new invoice in Zoho Books. Requires a customer_id and line_items array. Each line item needs at least an item_id or name with a rate and quantity.
zoho_books.zohobooks_update_invoice Write invoice_id, customer_id, line_items, date, due_date, notes, terms, status, reference_number Update an existing invoice in Zoho Books. Provide the invoice_id and any fields to change (line_items, dates, notes, status, etc.).
zoho_books.zohobooks_list_contacts Read contact_type, status, page, per_page, search_text List contacts (customers and vendors) from Zoho Books. Returns a paginated list with optional filters.
zoho_books.zohobooks_get_contact Read contact_id Get full details of a specific contact (customer or vendor) in Zoho Books, including addresses and contact persons.
zoho_books.zohobooks_create_contact Write name, email, phone, company_name, contact_type, billing_address, shipping_address, notes Create a new contact (customer or vendor) in Zoho Books. Requires a name; optionally provide email, phone, company name, and contact type.
zoho_books.zohobooks_list_items Read filter_type, page, per_page, search_text List items (products and services) from Zoho Books. Returns a paginated list with optional filters.
zoho_books.zohobooks_create_item Write name, rate, description, unit, item_type, tax_id, sku Create a new item (product or service) in Zoho Books. Requires a name and rate. Optionally specify item type, description, unit, and tax.
zoho_books.zohobooks_list_estimates Read status, customer_id, date_start, date_end, page, per_page, search_text List estimates (quotes) from Zoho Books. Returns a paginated list with optional filters for status, customer, and date range.
zoho_books.zohobooks_create_estimate Write customer_id, line_items, date, expiry_date, estimate_number, reference_number, notes, terms Create a new estimate (quote) in Zoho Books. Requires a customer_id and line_items array. Each line item needs at least an item_id or name with a rate and quantity.
zoho_books.zohobooks_get_current_user Read none Get information about the currently authenticated Zoho Books user. Useful for verifying connectivity and identifying the active account.

Automation Notes

Related Zoho Books CLI Pages

CI Zoho Books CLI for CI. Shell Scripts Zoho Books CLI for shell scripts. Headless Automation Zoho Books CLI for headless automation. Coding Agents Zoho Books CLI for coding agents.