Zoho Books API
Tools that enable LLMs to interact directly with the zoho-books API.
The Zoho Books API toolkit connects LLMs directly to Zoho Books, enabling full programmatic control over accounting, invoicing, purchasing, banking, payroll, and project management workflows across an organization.
Capabilities
- Contacts, vendors & organizations — Create, update, activate/deactivate, and delete contacts, contact persons, and addresses; import records from Zoho CRM; manage portal access, payment reminders, and 1099 tracking; list and manage organization users and settings.
- Sales & purchasing documents — Full CRUD and lifecycle management (draft → open → sent → approved → void) for estimates, invoices, retainer invoices, sales orders, sales receipts, purchase orders, and bills; apply/remove credits, generate payment links, export/print PDFs, send emails, and manage attachments and comments.
- Payments, credits & refunds — Record and update customer payments, vendor payments, credit notes, vendor credits, debit notes, and excess-payment refunds; apply credits to invoices/bills; bulk-delete payments; manage currency adjustments and exchange rates.
- Banking & bank feeds — Create, update, and delete bank/credit-card accounts and transactions; import bank statements; categorize, match, unmatch, exclude, and restore transactions; create and manage account rules for automated categorization.
- Accounting & fixed assets — Manage chart of accounts, journal entries, opening balances, taxes, tax groups, tax authorities, tax exemptions, and currencies; create, activate, depreciate, sell, and write off fixed assets and asset types.
- Projects, time tracking & items — Create and manage projects, tasks, and project users; log, start, stop, and delete time entries; manage inventory items including custom fields; create and manage recurring invoices, bills, and expenses; manage custom modules and locations.
OAuth
This toolkit uses OAuth 2.0 via the Zoho provider. See the Zoho auth provider docs for setup instructions.
Secrets
ZOHO_SERVER_URL — The base URL for the Zoho Books API, which varies by data center region. Zoho hosts data in multiple regions (US, EU, IN, AU, JP, CA, SA), each with a different API endpoint (e.g., https://www.zohoapis.com for the US, https://www.zohoapis.eu for the EU). You must supply the URL that matches the region where your Zoho Books organization is hosted. You can determine the correct URL from the Zoho API domain documentation. No special permissions beyond your OAuth token are needed — this value is a URL override, not a credential.
For guidance on configuring secrets in Arcade, see the Arcade secrets documentation. You can also manage secrets at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(511)
| Tool name | Description | Secrets | |
|---|---|---|---|
Mark a sent estimate as accepted if the customer has accepted it.
Use this tool to update the status of a sent estimate to accepted once your customer has approved it. | 1 | ||
Activate a bank account in Zoho Books.
This tool is used to mark a bank account as active in Zoho Books. It should be called when there is a need to change the status of a bank account to active. | 1 | ||
Activate a chart of account in Zoho Books.
Use this tool to update the status of a chart of account to active in Zoho Books. This is useful when you need to ensure an account is reactivated and available for transactions. | 1 | ||
Activate a contact in Zoho Books.
Use this tool to mark a contact as active in Zoho Books. It should be called when a contact's status needs to be changed from inactive to active. | 1 | ||
Activate a fixed asset to begin depreciation calculation.
Use this tool to mark a fixed asset as active, which will initiate the calculation of its depreciation. | 1 | ||
Activate an inactive item in Zoho Books.
Use this tool to reactivate an item that has been previously marked as inactive in Zoho Books. It should be called when you need to make an item available again for transactions. | 1 | ||
Mark an inactive user as active.
Use this tool to activate a user who is currently marked as inactive in the system. | 1 | ||
Enable automated payment reminders for invoices.
Activate automatic reminders for invoice payments to ensure timely settlements. | 1 | ||
Marks a location as active.
Use this tool to mark a specified location as active in the system. This is useful for enabling locations that were previously inactive. | 1 | ||
Activate a project in Zoho Books.
This tool marks a specified project as active in Zoho Books. Call this tool when you need to change the status of a project to active to enable its functionalities or integrations. | 1 | ||
Add a comment to a specific bill in Zoho Books.
Use this tool to add a comment to a bill identified by its ID in Zoho Books. Useful for internal notes or communication about a bill.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add an additional address to a contact in Zoho Books.
Use this tool to append a new address to an existing contact in Zoho Books. Suitable when updating contact details with more location information.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to an existing credit note.
Use this tool to append a comment to a specific credit note by providing the credit note's ID and the comment text. Ideal for documenting additional information or context on credit notes.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment for a specific estimate in Zoho Books.
Use this tool to add a comment to an existing estimate in Zoho Books. Call it when you need to append notes or feedback to an estimate record.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to a fixed asset in Zoho Books.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to a specific invoice.
Use this tool to add a comment to an invoice by specifying the invoice ID. Useful for internal notes or communication related to invoice handling.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to a journal entry in Zoho Books.
This tool adds a comment to a specified journal entry in Zoho Books. Call this tool when you need to annotate or provide additional information for a journal entry.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a task to a specific project.
Use this tool to add a task to a specified project in Zoho Books. It is suitable when you need to organize tasks within a project and track them through Zoho's project management system.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to a purchase order in Zoho Books.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to a specific retainer invoice.
This tool is used to add a comment to a specified retainer invoice in Zoho Books. It should be called when a user wishes to provide additional information or notes related to an existing retainer invoice.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to a sales order in Zoho Books.
This tool is used to add a comment to a specific sales order in Zoho Books. It should be called when you need to leave additional remarks or notes on a sales order.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Add a comment to an existing vendor credit.
Use this tool to add a comment to a vendor credit in Zoho Books. It should be called when you need to attach notes or additional information to a vendor credit entry.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Apply credit note to existing invoices in Zoho Books.
This tool applies a credit note to specific existing invoices within the Zoho Books platform. It should be called when you want to manage or adjust invoice balances by using available credit notes.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Apply customer credits to an invoice.
This tool applies customer credits, from credit notes or excess payments, to a specified invoice. It can apply multiple credits at once.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 | ||
Apply vendor credits to a bill.
This tool applies vendor credits from excess payments to a specified bill. It is useful for managing accounts and applying multiple credits at once.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
| 1 |