payments
Zoho Bills CLI for Headless Automation
Use the Zoho Bills 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 Bills 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 Bills CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Zoho Bills CLI for Headless Automation
kosmokrator integrations:configure zoho_bills --set access_token="$ZOHO_BILLS_ACCESS_TOKEN" --set organization_id="$ZOHO_BILLS_ORGANIZATION_ID" --enable --read allow --write ask --json
kosmo integrations:call zoho_bills.zoho_bills_list_invoices '{"page":1,"per_page":1,"status":"example_status","customer_id":"example_customer_id"}' --json Discovery Before Execution
Agents and scripts can inspect Zoho Bills docs and schemas before choosing a function.
kosmo integrations:docs zoho_bills --json
kosmo integrations:docs zoho_bills.zoho_bills_list_invoices --json
kosmo integrations:schema zoho_bills.zoho_bills_list_invoices --json
kosmo integrations:search "Zoho Bills" --json
kosmo integrations:list --json Useful Zoho Bills CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
zoho_bills.zoho_bills_list_invoices | Read | page, per_page, status, customer_id | List invoices from Zoho Bills. Optionally filter by status (draft, sent, overdue, paid, voided, partially_paid) or customer ID. |
zoho_bills.zoho_bills_get_invoice | Read | id | Retrieve a single invoice from Zoho Bills by its ID. Returns full invoice details including line items, totals, and status. |
zoho_bills.zoho_bills_create_invoice | Write | customer_id, line_items, date, due_date | Create a new invoice in Zoho Bills. Provide a customer ID, line items, and optional date/due date. Each line item should include item_id or a name, plus rate and quantity. |
zoho_bills.zoho_bills_list_customers | Read | page, per_page, type | List customers (contacts) from Zoho Bills. Optionally filter by type (customer or vendor). Returns paginated results. |
zoho_bills.zoho_bills_get_customer | Read | id | Retrieve a single customer (contact) from Zoho Bills by ID. Returns full contact details including billing address and contact persons. |
zoho_bills.zoho_bills_list_items | Read | page, per_page | List items (products and services) from Zoho Bills. Returns paginated results with item details like name, rate, and description. |
zoho_bills.zoho_bills_get_current_user | Read | none | Get the currently authenticated Zoho Bills user profile. Useful for verifying connectivity and checking user permissions. |
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.