accounting
Zoho Invoice CLI for Headless Automation
Use the Zoho Invoice CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Manual OAuth token auth
Zoho Invoice 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 Invoice CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Zoho Invoice CLI for Headless Automation
kosmokrator integrations:configure zoho_invoice --set access_token="$ZOHO_INVOICE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call zoho_invoice.zohoinvoice_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,"sort_column":"example_sort_column","sort_order":"example_sort_order"}' --json Discovery Before Execution
Agents and scripts can inspect Zoho Invoice docs and schemas before choosing a function.
kosmo integrations:docs zoho_invoice --json
kosmo integrations:docs zoho_invoice.zohoinvoice_list_invoices --json
kosmo integrations:schema zoho_invoice.zohoinvoice_list_invoices --json
kosmo integrations:search "Zoho Invoice" --json
kosmo integrations:list --json Useful Zoho Invoice CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
zoho_invoice.zohoinvoice_list_invoices | Read | status, customer_id, date_start, date_end, page, per_page, sort_column, sort_order | List invoices from Zoho Invoice. Supports filtering by status (draft, sent, overdue, paid, void, partially_paid), customer, and date range. |
zoho_invoice.zohoinvoice_get_invoice | Read | invoice_id | Get full details of a single invoice by its ID, including line items, totals, payments, and notes. |
zoho_invoice.zohoinvoice_create_invoice | Write | customer_id, line_items, invoice_number, date, due_date, notes, terms, reference_number | Create a new invoice in Zoho Invoice. Requires at minimum a customer_id and one line item. Returns the created invoice with its ID and total. |
zoho_invoice.zohoinvoice_list_contacts | Read | type, status, page, per_page, search_text | List contacts (customers and vendors) from Zoho Invoice. Supports filtering by type (customer or vendor) and pagination. |
zoho_invoice.zohoinvoice_list_items | Read | type, status, page, per_page, search_text | List items (products and services) from Zoho Invoice. Use item IDs when creating invoices with line items. |
zoho_invoice.zohoinvoice_list_payments | Read | customer_id, date_start, date_end, payment_mode, page, per_page | List payments received in Zoho Invoice. Supports filtering by customer, date range, and payment mode. |
zoho_invoice.zohoinvoice_get_current_user | Read | none | Get the authenticated user's profile from Zoho Invoice, including name, email, and role. |
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.