Zohobook API Integration Vol.1
These are the list of integration use cases supported by Knit for Zohobook API as part of the ACCOUNTING category
Create a retainerinvoice
ID
: create_a_retainerinvoiceOperation
: writeEntities
: line item, retainer invoice, customerSummary
: This API creates a retainer invoice for a customer in Zoho Books. It requires the customer ID and line items as mandatory fields. Optional fields include reference number, date, contact persons, custom fields, notes, terms, payment options, template ID, and place of supply. The API supports OAuth for authorization. The response includes details of the created retainer invoice, such as invoice ID, number, date, status, customer details, line items, taxes, payment options, and addresses.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a vendor credit
ID
: create_a_vendor_creditOperation
: writeEntities
: vendor credit, line item, vendorSummary
: The 'Create a vendor credit' API allows you to create a vendor credit for a vendor in Zoho Books. It requires an OAuth token for authorization. The API accepts various parameters including vendor_id (required), currency_id, vat_treatment, vendor_credit_number, gst_treatment, tax_treatment, gst_no, source_of_supply, destination_of_supply, place_of_supply, pricebook_id, reference_number, is_update_customer, date, exchange_rate, is_inclusive_tax, line_items, notes, documents, and custom_fields. The response includes details of the created vendor credit such as vendor_credit_id, vendor_credit_number, date, source_of_supply, destination_of_supply, place_of_supply, gst_no, gst_treatment, tax_treatment, pricebook_id, is_reverse_charge_applied, status, reference_number, vendor_id, vendor_name, currency_id, currency_code, exchange_rate, price_precision, vat_treatment, filed_in_vat_return_id, filed_in_vat_return_name, filed_in_vat_return_type, is_inclusive_tax, line_items, acquisition_vat_summary, acquisition_vat_total, reverse_charge_vat_summary, reverse_charge_vat_total, documents, custom_fields, sub_total, total, total_credits_used, total_refunded_amount, balance, notes, comments, vendor_credit_refunds, bills_credited, created_time, and last_modified_time.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a base currency adjustment
ID
: create_base_currency_adjustmentOperation
: writeEntities
: base currency adjustment, currency, accountSummary
: This API creates a base currency adjustment for a specified currency. It requires the currency ID, adjustment date, exchange rate, and notes as input parameters. The request must include the organization ID and account IDs as query parameters. The response includes a confirmation message and details of the adjustment, such as the adjustment ID, date, exchange rate, currency ID, and account balances.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a Bank Account
ID
: delete_a_bank_accountOperation
: writeEntities
:Summary
: The 'Delete a Bank Account' API allows users to delete a specified account from the Zoho Books system. The account to be deleted must not be associated with any transactions or products. The API requires an OAuth token for authorization, which should be included in the request headers. The account ID to be deleted is specified in the path parameters, and the organization ID is specified as a query parameter. Upon successful deletion, the API returns a response with a code and message indicating the account has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a bill
ID
: delete_a_billOperation
: writeEntities
: bill, authorization, organizationSummary
: The 'Delete a bill' API allows users to delete an existing bill in the Zoho Books system. It requires the bill ID and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. The API responds with a code and message indicating whether the bill was successfully deleted. Note that bills with payments applied cannot be deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a comment
ID
: delete_a_commentOperation
: writeEntities
: comment, organization, vendor creditSummary
: This API deletes a comment associated with a vendor credit in Zoho Books. It requires the vendor credit ID and comment ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating the comment has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a Contact
ID
: delete_a_contactOperation
: writeEntities
: contactSummary
: The 'Delete a Contact' API allows users to delete an existing contact from their Zoho Books account. The API requires an OAuth token for authorization, which should be included in the request headers. The contact to be deleted is specified by the 'contact_id' path parameter, and the organization is identified by the 'organization_id' query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the contact has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a contact person
ID
: delete_a_contact_personOperation
: writeEntities
: contactSummary
: This API deletes an existing contact person in the Zoho Books system. It requires the contact person's ID and the organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code of 0 and a message indicating that the contact person has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a credit note
ID
: delete_a_credit_noteOperation
: writeEntities
: credit note, organizationSummary
: This API deletes an existing credit note in the Zoho Books system. It requires the credit note ID and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code of 0 and a message indicating that the credit note has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a currency
ID
: delete_a_currencyOperation
: writeEntities
: currency, organization, transactionSummary
: The 'Delete a currency' API allows users to delete a specified currency from the Zoho Books settings. It requires an OAuth token for authorization, the currency ID to specify which currency to delete, and the organization ID to specify the organization context. The API uses the DELETE method and returns a response code and message indicating whether the currency was successfully deleted. Note that currencies associated with transactions cannot be deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a journal
ID
: delete_a_journalOperation
: writeEntities
: authorization, organization, journalSummary
: The 'Delete a journal' API allows users to delete a specific journal entry from their Zoho Books account. The API requires an OAuth token for authorization, which should be included in the request headers. The journal ID to be deleted must be specified in the path parameters, and the organization ID must be provided as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the journal entry has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a payment
ID
: delete_a_paymentOperation
: writeEntities
: payment, organization, customerSummary
: The 'Delete a payment' API allows users to delete an existing payment in the Zoho Books system. It requires an OAuth token for authorization, the payment ID of the payment to be deleted, and the organization ID as query parameters. The API uses the DELETE method and returns a response code and message indicating the success or failure of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a receipt
ID
: delete_a_receiptOperation
: writeEntities
: receipt, organization, expenseSummary
: The 'Delete a receipt' API allows users to delete the receipt attached to a specific expense in Zoho Books. The API requires an OAuth token for authorization, which should be included in the request headers. The expense ID must be specified in the path parameters, and the organization ID must be included as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the receipt has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a recurring bill
ID
: delete_a_recurring_billOperation
: writeEntities
: recurring bill, organizationSummary
: This API deletes an existing recurring bill in the Zoho Books system. It requires the recurring bill ID and the organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating the operation's success.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a recurring expense
ID
: delete_a_recurring_expenseOperation
: writeEntities
: recurring expense, organizationSummary
: This API endpoint is used to delete an existing recurring expense in Zoho Books. It requires the recurring expense ID and the organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating the recurring expense has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a Recurring Invoice
ID
: delete_a_recurring_invoiceOperation
: writeEntities
: organization, recurring invoiceSummary
: This API deletes an existing recurring invoice in the Zoho Books system. It requires the invoice ID and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a Refund
ID
: delete_a_refundOperation
: writeEntities
: refund, organization, customer paymentSummary
: The 'Delete a Refund' API allows you to delete a refund associated with an existing customer payment in Zoho Books. To use this API, you need to provide the OAuth token in the Authorization header. The API requires the payment ID as a path parameter and the organization ID as a query parameter. Upon successful deletion, the API returns a response code of 0 and a message indicating that the refund has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a retainer invoice
ID
: delete_a_retainer_invoiceOperation
: writeEntities
: payment, credit note, retainer invoiceSummary
: This API deletes an existing retainer invoice in Zoho Books. It requires the invoice ID and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. The API will return a response code and message indicating whether the deletion was successful. Note that invoices with payments or credit notes applied cannot be deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a rule
ID
: delete_a_ruleOperation
: writeEntities
: rule, transaction, bank accountSummary
: The 'Delete a rule' API allows users to delete a specific rule from their account, making it no longer applicable to transactions. The API requires an OAuth token for authorization, which should be included in the request headers. The rule to be deleted is specified by the 'rule_id' path parameter, and the organization is identified by the 'organization_id' query parameter. Upon successful deletion, the API returns a response with a code and message indicating the rule has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a tax
ID
: delete_a_taxOperation
: writeEntities
: tax, organizationSummary
: The 'Delete a tax' API allows users to delete a simple or compound tax from their Zoho Books account. It requires an OAuth token for authorization, which must be included in the request headers. The API endpoint requires the tax ID as a path parameter and the organization ID as a query parameter. Upon successful deletion, the API returns a response code and a message indicating that the record has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a tax group
ID
: delete_a_tax_groupOperation
: deleteEntities
: transaction, organization, tax groupSummary
: This API deletes a specified tax group in Zoho Books. The tax group to be deleted must not be associated with any transactions. The request requires an OAuth token for authorization, the tax group ID as a path parameter, and the organization ID as a query parameter. Upon successful deletion, the API returns a response code and message indicating the tax group has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a transaction
ID
: delete_a_transactionOperation
: writeEntities
: organization, transaction, accountSummary
: This API deletes a specified transaction from the chart of accounts in Zoho Books. It requires an OAuth token for authorization, the transaction ID as a path parameter, and the organization ID as a query parameter. Upon successful deletion, it returns a response code and message indicating the transaction has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a bill
ID
: delete_accounts_payable_invoiceOperation
: writeEntities
:Summary
: The 'Delete a bill' API allows users to delete an existing bill in the Zoho Books system. It requires the bill ID and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. The API responds with a code and message indicating whether the bill was successfully deleted. Note that bills with payments applied cannot be deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete Additional Address
ID
: delete_additional_addressOperation
: writeEntities
: address, organization, contactSummary
: The 'Delete Additional Address' API allows you to delete an additional address associated with a contact in Zoho Books. To use this API, you need to provide the contact ID and address ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating the address has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an account
ID
: delete_an_accountOperation
: writeEntities
: product, account, transactionSummary
: The 'Delete an account' API allows users to delete a specified account from the Zoho Books system. The account to be deleted must not be associated with any transactions or products. The API requires an OAuth token for authorization, which should be included in the request headers. The account ID to be deleted is specified in the path parameters, and the organization ID is specified as a query parameter. Upon successful deletion, the API returns a response with a code and message indicating the account has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an attachment
ID
: delete_an_attachmentOperation
: writeEntities
: invoice, attachment, organizationSummary
: The 'Delete an attachment' API allows users to delete a file attached to a specific invoice in Zoho Books. The API requires an OAuth token for authorization, which should be included in the request headers. The invoice ID from which the attachment is to be deleted is specified as a path parameter, and the organization ID is provided as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the file is no longer attached to the invoice.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an employee
ID
: delete_an_employeeOperation
: writeEntities
: organization, employeeSummary
: The 'Delete an employee' API allows you to delete an existing employee from the Zoho Books system. It requires an OAuth token for authorization, which should be included in the request headers. The organization_id must be specified as a query parameter to identify the organization from which the employee is to be deleted. Upon successful deletion, the API returns a response with a code and a message indicating that the employee has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an Estimate
ID
: delete_an_estimateOperation
: writeEntities
: organization, estimateSummary
: The 'Delete an Estimate' API allows users to delete an existing estimate in the Zoho Books application. The API requires an OAuth token for authorization, which must be included in the request headers. The request URL must include the estimate ID as a path parameter and the organization ID as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the estimate has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an Expense
ID
: delete_an_expenseOperation
: writeEntities
: authorization, organization, expenseSummary
: The 'Delete an Expense' API allows users to delete an existing expense in the Zoho Books application. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the expense ID as a path parameter and the organization ID as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the expense has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an invoice
ID
: delete_an_invoiceOperation
: writeEntities
: payment, invoice, credit noteSummary
: The 'Delete an invoice' API allows users to delete an existing invoice in the Zoho Books system. It requires the invoice ID and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. The API responds with a code and message indicating the success or failure of the operation. Invoices with payments or credit notes applied cannot be deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an item
ID
: delete_an_itemOperation
: writeEntities
: item, transaction, organizationSummary
: This API deletes an item from Zoho Books. The item to be deleted is specified by the item_id in the path parameters. The organization_id must be provided as a query parameter. The request requires an Authorization header with a valid OAuth token. The API responds with a code and message indicating the success or failure of the operation. Items that are part of a transaction cannot be deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete applied credit
ID
: delete_applied_creditOperation
: writeEntities
: credit, invoiceSummary
: The 'Delete applied credit' API allows users to delete a specific credit that has been applied to an invoice in Zoho Books. The API requires the invoice ID and the credit ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and a message indicating that the credits applied to the invoice have been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a base currency adjustment
ID
: delete_base_currency_adjustmentOperation
: writeEntities
: base currency adjustment, organizationSummary
: This API deletes a specified base currency adjustment in Zoho Books. It requires an OAuth token for authorization, the ID of the base currency adjustment to be deleted, and the organization ID as query parameters. The response includes a code and a message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete bills credited
ID
: delete_bills_creditedOperation
: deleteEntities
: bill, vendor creditSummary
: The 'Delete bills credited' API deletes the credits applied to a specific bill. To use this API, you must provide the 'vendor_credit_bill_id' as a path parameter, which can be obtained from the 'Get vendor credits > bills credited > vendor_credit_bill_id' section. The request requires an OAuth token for authorization, which should be included in the headers. The 'organization_id' must be provided as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the credits have been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete comment
ID
: delete_commentOperation
: writeEntities
: project, comment, organizationSummary
: The 'Delete comment' API allows users to delete a specific comment from a project in Zoho Books. The API requires the project ID and comment ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating the comment has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete credit note refund
ID
: delete_credit_note_refundOperation
: writeEntities
: credit note refund, organizationSummary
: The 'Delete credit note refund' API allows users to delete a specific refund associated with a credit note in Zoho Books. The API requires the credit note ID, refund ID, and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete Custom Modules
ID
: delete_custom_modulesOperation
: writeEntities
: custom module, authorization, organizationSummary
: The 'Delete Custom Modules' API allows users to delete a custom module in Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint is 'https://www.zohoapis.com/books/v3/cm_debtor', and it uses the DELETE method. The request must include the 'organization_id' as a query parameter to specify which organization's module is to be deleted. Upon successful deletion, the API returns a response with a code and a message indicating that the module record has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete an exchange rate
ID
: delete_exchange_rateOperation
: writeEntities
: exchange rate, currency, organizationSummary
: This API deletes an exchange rate for a specified currency in the Zoho Books application. It requires an OAuth token for authorization, and the request must include the currency ID and exchange rate ID as path parameters, as well as the organization ID as a query parameter. The API responds with a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete the expense receipt
ID
: delete_expense_receiptOperation
: writeEntities
: invoice, receipt, expenseSummary
: This API deletes the expense receipts attached to an invoice which is raised from an expense. It requires an OAuth token for authorization and the organization ID as a query parameter. The API responds with a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete individual records
ID
: delete_individual_recordsOperation
: writeEntities
: module, organization, recordSummary
: The 'Delete individual records' API allows you to delete a specific record from a custom module in Zoho Books. To use this API, you need to provide the record ID in the path parameters and the organization ID as a query parameter. The request must include an 'Authorization' header with a valid OAuth token. Upon successful deletion, the API returns a response with a code of 0 and a message indicating success.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete invoices credited
ID
: delete_invoices_creditedOperation
: writeEntities
: invoice, credit note, organizationSummary
: The 'Delete invoices credited' API allows users to delete credits that have been applied to a specific invoice. The API requires the credit note ID and invoice ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and message indicating that the credits have been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete last imported statement
ID
: delete_last_imported_statementOperation
: deleteEntities
: statement, organization, bank accountSummary
: The 'Delete last imported statement' API allows users to delete the last imported bank statement for a specified bank account in Zoho Books. The API requires an OAuth token for authorization, and the request must include the bank account ID, statement ID, and organization ID as path and query parameters. Upon successful deletion, the API returns a response code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete opening balance
ID
: delete_opening_balanceOperation
: writeEntities
: organization, opening balanceSummary
: The 'Delete opening balance' API allows users to delete an entered opening balance for a specified organization in Zoho Books. The API requires an OAuth token for authorization, which must be included in the request headers. The organization ID must be provided as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the opening balance has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete project
ID
: delete_projectOperation
: writeEntities
: project, authorization, organizationSummary
: The 'Delete project' API allows users to delete an existing project in Zoho Books. It requires the project ID and organization ID as path and query parameters, respectively. The request must include an 'Authorization' header with a valid OAuth token. Upon successful deletion, the API returns a response with a code of 0 and a message indicating that the project has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete purchase order
ID
: delete_purchase_orderOperation
: writeEntities
: purchase order, authorizationSummary
: The 'Delete purchase order' API allows users to delete an existing purchase order in the Zoho Books system. It requires an OAuth token for authorization, which must be included in the request headers. The organization ID must be specified as a query parameter. Upon successful deletion, the API returns a response with a code and a message indicating that the purchase order has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a sales order
ID
: delete_sales_orderOperation
: writeEntities
: organization, sales orderSummary
: This API deletes an existing sales order in the Zoho Books system. It requires the sales order ID and the organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. The API responds with a code and message indicating the success or failure of the operation. Note that invoiced sales orders cannot be deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete Task
ID
: delete_taskOperation
: writeEntities
: project, organization, taskSummary
: The Delete Task API allows you to delete a specific task from a project in Zoho Books. To use this API, you need to provide the project ID and task ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and a message indicating that the task has been deleted successfully.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a tax authority [US and CA Edition only]
ID
: delete_tax_authority_us_and_ca_edition_onlyOperation
: writeEntities
: setting, tax authority, organizationSummary
: This API deletes a tax authority in Zoho Books for US and CA editions only. It requires an OAuth token for authorization. The request must include the tax authority ID as a path parameter and the organization ID as a query parameter. Upon successful deletion, the API returns a response code and a message indicating that the tax authority has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a tax exemption [US Edition only]
ID
: delete_tax_exemption_us_edition_onlyOperation
: writeEntities
: setting, tax exemption, organizationSummary
: This API deletes a tax exemption for a specified organization in the US edition of Zoho Books. It requires an OAuth token for authorization, the tax exemption ID as a path parameter, and the organization ID as a query parameter. Upon successful deletion, it returns a response code and a message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete time entries
ID
: delete_time_entriesOperation
: deleteEntities
: project, time entry, organizationSummary
: The 'Delete time entries' API allows users to delete time entries from a project in Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The organization_id must be specified as a query parameter to identify the organization from which the time entries are to be deleted. Upon successful deletion, the API returns a response with a code and a message indicating that the selected timesheet entries have been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete time entry
ID
: delete_time_entryOperation
: writeEntities
: project, time entrySummary
: The 'Delete time entry' API allows users to delete a specific time entry from a project in Zoho Books. The API requires an OAuth token for authentication, which should be included in the 'Authorization' header. The 'time_entry_id' is a path parameter that specifies the ID of the time entry to be deleted, and 'organization_id' is a query parameter that specifies the ID of the organization. Upon successful deletion, the API returns a response with a code and message indicating the time entry has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete user
ID
: delete_userOperation
: writeEntities
: project, organization, userSummary
: The 'Delete user' API is used to remove a user from a specified project within an organization in Zoho Books. The API requires an OAuth token for authorization, which must be included in the request headers. The request URL must include the project ID and user ID as path parameters, and the organization ID as a query parameter. Upon successful execution, the API returns a response code and message indicating that the user has been removed from the project.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete vendor credit
ID
: delete_vendor_creditOperation
: deleteEntities
: vendor creditSummary
: The 'Delete vendor credit' API allows you to delete a specific vendor credit in Zoho Books. To use this API, you need to provide the vendor credit ID as a path parameter and the organization ID as a query parameter. The request must include an 'Authorization' header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and a message indicating that the vendor credit has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete vendor credit refund
ID
: delete_vendor_credit_refundOperation
: writeEntities
: vendor credit, refund, organizationSummary
: The 'Delete vendor credit refund' API allows you to delete a specific refund associated with a vendor credit in Zoho Books. To use this API, you need to provide the vendor credit ID and the refund ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response with a code and a message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete a vendor payment
ID
: delete_vendor_paymentOperation
: writeEntities
:Summary
: This API deletes an existing vendor payment in Zoho Books. It requires the vendor payment ID and organization ID as path and query parameters, respectively. The request must include an Authorization header with a valid OAuth token. Upon successful deletion, the API returns a response code of 0 and a message indicating that the payment has been deleted.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a bill
ID
: get_a_billOperation
: readEntities
: bill, purchase order, vendorSummary
: The 'Get a bill' API retrieves the details of a specific bill from Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the bill ID as a path parameter and the organization ID as a query parameter. The response includes detailed information about the bill, such as vendor details, VAT treatment, status, line items, payments, and more. The response is structured in a JSON format with a 'code' indicating success or failure and a 'message' providing additional information. The 'bill' object contains comprehensive details about the bill, including its ID, vendor information, line items, taxes, payments, and other related data.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a bill attachment
ID
: get_a_bill_attachmentOperation
: readEntities
: bill, attachmentSummary
: The 'Get a bill attachment' API retrieves the file attached to a specified bill in Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the bill ID as a path parameter and the organization ID as a query parameter. An optional query parameter 'preview' can be used to request a thumbnail of the attachment. The response includes a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a contact person
ID
: get_a_contact_personOperation
: readEntities
: contact person, contactSummary
: The 'Get a contact person' API retrieves the details of a specific contact person associated with a contact in Zoho Books. It requires an OAuth token for authorization, and the contact ID, contact person ID, and organization ID as parameters. The response includes details such as the contact person's name, email, phone numbers, designation, department, and whether they are the primary contact or added in the portal.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a credit note
ID
: get_a_credit_noteOperation
: readEntities
: line item, credit note, customerSummary
: The 'Get a credit note' API retrieves the details of an existing credit note from Zoho Books. It requires an OAuth token for authorization and the credit note ID as a path parameter. The API supports optional query parameters such as 'print' to export the credit note as a PDF and 'accept' to specify the format of the response (json, pdf, or html). The response includes detailed information about the credit note, such as its ID, number, date, status, customer details, line items, invoices, taxes, and addresses. The API is useful for obtaining comprehensive information about a specific credit note in a specified format.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a Currency
ID
: get_a_currencyOperation
: readEntities
: setting, currency, organizationSummary
: The 'Get a Currency' API retrieves the details of a specific currency using its currency ID. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes the currency ID, code, name, symbol, price precision, format, and a flag indicating if it is the base currency.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a project
ID
: get_a_projectOperation
: readEntities
: project, task, customerSummary
: The 'Get a project' API retrieves the details of a specific project from Zoho Books. It requires an OAuth token for authentication, which should be included in the request headers. The API endpoint requires the project ID as a path parameter and the organization ID as a query parameter. The response includes detailed information about the project, such as project ID, name, customer details, currency, description, status, billing type, rate, budget, hours, amounts, and associated tasks. The response also indicates if the project is shown in the dashboard and if there are any recurring invoices associated with it.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a purchase order
ID
: get_a_purchase_orderOperation
: readEntities
: purchase order, line item, vendorSummary
: The 'Get a purchase order' API retrieves the details of a specific purchase order from Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API requires a path parameter 'purchaseOrderId' to specify the purchase order to retrieve. It also supports optional query parameters such as 'print' to print the exported PDF and 'accept' to specify the format of the response (json, pdf, or html). The default response format is JSON. The response includes detailed information about the purchase order, such as purchase order ID, vendor details, line items, billing and delivery addresses, and various tax and discount details. The API is useful for obtaining comprehensive information about purchase orders for further processing or analysis.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a recurring bill
ID
: get_a_recurring_billOperation
: readEntities
: line item, recurring bill, vendorSummary
: The 'Get a recurring bill' API retrieves the details of a specific recurring bill from Zoho Books. It requires an OAuth token for authorization and the recurring bill ID as a path parameter. The organization ID must be provided as a query parameter. The API returns detailed information about the recurring bill, including vendor details, status, currency, supply details, tax information, line items, and custom fields. The response includes a success code and message, along with the full details of the recurring bill.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a recurring expense
ID
: get_a_recurring_expenseOperation
: readEntities
: recurring expense, account, customerSummary
: The 'Get a recurring expense' API retrieves the details of a specific recurring expense from Zoho Books. It requires an OAuth token for authorization and the organization ID as a query parameter. The API returns detailed information about the recurring expense, including its ID, recurrence name, start and end dates, tax details, account information, and customer details. The response includes a comprehensive breakdown of the expense, including line items and tax summaries.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a Recurring Invoice
ID
: get_a_recurring_invoiceOperation
: readEntities
: recurring invoice, line item, customerSummary
: The 'Get a Recurring Invoice' API retrieves the details of a specific recurring invoice using its ID. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes detailed information about the recurring invoice, such as customer details, line items, billing and shipping addresses, and payment options. The API also provides pagination context for the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a retainer invoice
ID
: get_a_retainer_invoiceOperation
: readEntities
: payment, retainer invoice, customerSummary
: The 'Get a retainer invoice' API retrieves the details of a specific retainer invoice using its ID. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes comprehensive details about the retainer invoice such as invoice number, date, status, customer details, line items, taxes, payment information, and addresses. The API is useful for obtaining detailed information about a retainer invoice for a given organization.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a rule
ID
: get_a_ruleOperation
: readEntities
: rule, bank account, customerSummary
: The 'Get a rule' API retrieves details of a specific rule in the Zoho Books banking module. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes details such as the rule ID, name, order, criteria, and associated account and customer information.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a sales order
ID
: get_a_sales_orderOperation
: readEntities
: sales order, line item, customerSummary
: The 'Get a sales order' API retrieves the details of a specific sales order from Zoho Books. It requires an OAuth token for authorization and the sales order ID as a path parameter. The organization ID is a mandatory query parameter, while 'print' and 'accept' are optional query parameters that control the output format and whether to print the PDF. The response includes detailed information about the sales order, such as customer details, billing and shipping addresses, tax information, line items, and custom fields.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a task
ID
: get_a_taskOperation
: readEntities
: project, taskSummary
: The 'Get a task' API retrieves the details of a specific task within a project in Zoho Books. It requires an OAuth token for authorization, and the request must include the project ID and task ID as path parameters, as well as the organization ID as a query parameter. The response includes the task details such as project ID, project name, task ID, task name, description, rate, status, and whether the task is billable.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a tax
ID
: get_a_taxOperation
: readEntities
: tax, tax authority, organizationSummary
: The 'Get a tax' API retrieves the details of a specific tax, which can be either simple or compound. It requires an OAuth token for authorization and the organization ID as a query parameter. The API returns a response containing the tax details, including tax ID, name, percentage, type, authority details, and more. The response code and message indicate the success or failure of the request.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a tax group
ID
: get_a_tax_groupOperation
: readEntities
: tax, tax authority, tax groupSummary
: The 'Get a tax group' API retrieves the details of a specific tax group using its ID. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes the tax group ID, name, percentage, and details of the taxes within the group, such as tax ID, name, percentage, type, factor, and authority information.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a time entry
ID
: get_a_time_entryOperation
: readEntities
: project, time entry, customerSummary
: The 'Get a time entry' API retrieves details of a specific time entry from Zoho Books. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes detailed information about the time entry, such as the project and customer details, task information, user details, log times, billing status, and other relevant metadata.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a User
ID
: get_a_userOperation
: readEntities
: project, organization, userSummary
: The 'Get a User' API retrieves details of a specific user within a project. It requires an OAuth token for authorization, and the request must include the project ID and user ID as path parameters, as well as the organization ID as a query parameter. The response includes the user's ID, name, email, role, and cost rate, along with a success message and code.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get account details
ID
: get_account_detailsOperation
: readEntities
: organization, bank, accountSummary
: The 'Get account details' API provides detailed information about a specified bank account. It requires an OAuth token for authorization, the organization ID as a query parameter, and the account ID as a path parameter. The API returns a comprehensive set of details about the bank account, including its ID, name, currency details, account type, balance, bank name, and other attributes. The response includes a success code and message, along with the bank account details.Input Fields
: Input FieldsOutput Fields
: Output Fields
List account details for base currency adjustment
ID
: get_account_details_for_base_currency_adjustmentOperation
: readEntities
: adjustment, currency, accountSummary
: This API lists the account details for a base currency adjustment. It requires the organization ID, currency ID, adjustment date, exchange rate, and notes as query parameters. The API returns a list of accounts affected by the given exchange rate adjustment, including details such as account ID, account name, balances in base and foreign currencies, adjusted balance, and gain or loss from the adjustment. The response also includes the adjustment date, exchange rate, currency ID, and notes.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an account
ID
: get_an_accountOperation
: readEntities
: custom field, currency, accountSummary
: The 'Get an account' API retrieves the details of a specific account using the account ID. It requires an OAuth token for authorization, the account ID as a path parameter, and the organization ID as a query parameter. The response includes detailed information about the account such as account ID, name, code, type, currency details, description, and various flags indicating the account's status and involvement in transactions. Custom fields, closing balance, parent account ID, associated documents, and timestamps for creation and last modification are also provided in the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an employee
ID
: get_an_employeeOperation
: readEntities
: organization, employeeSummary
: The 'Get an employee' API retrieves the details of an employee from the Zoho Books system. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the organization_id as a query parameter to specify which organization's employee details are being requested. Upon a successful request, the API returns a response with a code indicating success, a message, and the employee's details including their ID, name, and email.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an estimate
ID
: get_an_estimateOperation
: readEntities
: line item, estimate, customerSummary
: The 'Get an estimate' API retrieves the details of a specific estimate from Zoho Books. It requires an OAuth token for authentication and the estimate ID as a path parameter. The organization ID is a required query parameter, while 'print' and 'accept' are optional query parameters that control the output format and whether to print the PDF. The response includes detailed information about the estimate, such as estimate number, date, customer details, line items, taxes, and addresses. The API supports multiple response formats including JSON, PDF, and HTML.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an Expense
ID
: get_an_expenseOperation
: readEntities
: tax, account, expenseSummary
: The 'Get an Expense' API retrieves the details of a specific expense from Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the 'expense_id' as a path parameter and 'organization_id' as a query parameter. The response includes detailed information about the expense, such as transaction type, GST details, tax amounts, account information, and more. The response is structured with a 'code' indicating success or failure, a 'message', and an 'expense' object containing all the relevant details of the expense.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an invoice
ID
: get_an_invoiceOperation
: readEntities
: item, invoice, customerSummary
: The 'Get an invoice' API retrieves the details of a specific invoice from Zoho Books. It requires an OAuth token for authorization and the invoice ID as a path parameter. The organization ID is a mandatory query parameter. Optional query parameters include 'print' to print the exported PDF and 'accept' to specify the format of the invoice details (json, pdf, html). The response includes a detailed invoice object with fields such as invoice ID, customer details, line items, taxes, and payment information.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an item
ID
: get_an_itemOperation
: readEntities
: item, warehouse, taxSummary
: The 'Get an item' API retrieves details of an existing item from Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the organization ID as a query parameter. Upon a successful request, the API returns a response containing the item details, including item ID, name, status, description, rate, unit, tax information, SKU, product type, and warehouse details.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get a base currency adjustment
ID
: get_base_currency_adjustmentOperation
: readEntities
: base currency adjustment, currency, accountSummary
: This API retrieves the details of a base currency adjustment for a specified organization in Zoho Books. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes the adjustment ID, date, exchange rate, currency ID, account details, notes, and currency code.Input Fields
: Input FieldsOutput Fields
: Output Fields
Bulk export estimates
ID
: get_bulk_export_estimatesOperation
: readEntities
: organization, pdf, estimateSummary
: The Bulk export estimates API allows users to export up to 25 estimates in a single PDF document. It requires an OAuth token for authorization and takes query parameters including 'organization_id' and 'estimate_ids'. The 'estimate_ids' parameter is a comma-separated list of estimate IDs to be exported. The API returns a response code and message indicating the success or failure of the request.Input Fields
: Input FieldsOutput Fields
: Output Fields
Bulk export Invoices
ID
: get_bulk_export_invoicesOperation
: readEntities
: invoice, pdf, organizationSummary
: The Bulk export Invoices API allows users to export up to 25 invoices in a single PDF document. It requires an OAuth token for authorization and takes query parameters including 'organization_id' and 'invoice_ids'. The 'invoice_ids' parameter is a comma-separated list of invoice IDs to be exported. The API returns a response with a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Bulk export sales orders
ID
: get_bulk_export_sales_ordersOperation
: readEntities
: pdf, organization, sales orderSummary
: The Bulk export sales orders API allows users to export up to 25 sales orders in a single PDF document. The API requires an OAuth token for authorization, which should be included in the request headers. The organization_id must be specified as a query parameter to identify the organization whose sales orders are to be exported. Upon successful execution, the API returns a response with a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Bulk print estimates
ID
: get_bulk_print_estimatesOperation
: readEntities
: organization, estimateSummary
: The Bulk print estimates API allows users to export estimates as PDF and print them. A maximum of 25 estimates can be printed at a time. The API requires an OAuth token for authorization and takes query parameters including 'organization_id' and 'estimate_ids'. The 'estimate_ids' parameter is a comma-separated list of estimate IDs to be printed. The response includes a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Bulk print invoices
ID
: get_bulk_print_invoicesOperation
: readEntities
: invoice, pdf, organizationSummary
: The Bulk print invoices API allows users to export and print up to 25 invoices as a PDF. It requires an OAuth token for authorization, and the organization ID and a comma-separated list of invoice IDs as query parameters. The API returns a response code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Bulk print sales orders
ID
: get_bulk_print_sales_ordersOperation
: readEntities
: organization, sales orderSummary
: The Bulk print sales orders API allows users to export and print up to 25 sales orders as a PDF. It requires an OAuth token for authorization, which should be included in the request headers. The organization_id must be specified as a query parameter to identify the organization whose sales orders are to be printed. The API responds with a success message and a code indicating the result of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
List comments
ID
: get_comments_for_projectOperation
: readEntities
: project, commentSummary
: The 'List comments' API retrieves comments for a specified project within an organization. It requires an OAuth token for authorization, the project ID as a path parameter, and the organization ID as a query parameter. The response includes a list of comments with details such as comment ID, project ID, description, user information, and timestamps.Input Fields
: Input FieldsOutput Fields
: Output Fields
List Organizations
ID
: get_companies_infoOperation
: readEntities
:Summary
: The 'Get Organizations' API retrieves a list of all organizations.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get Contact
ID
: get_contactOperation
: readEntities
: shipping address, billing address, contactSummary
: The Get Contact API retrieves the details of a specific contact from Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires a contact ID as a path parameter and an organization ID as a query parameter. The response includes detailed information about the contact, such as contact name, company name, contact type, tax details, billing and shipping addresses, contact persons, and default templates. The response also includes metadata such as creation and last modified times.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get Contact Addresses
ID
: get_contact_addressesOperation
: readEntities
: address, contactSummary
: The Get Contact Addresses API retrieves all addresses associated with a specific contact in Zoho Books, including shipping, billing, and additional addresses. It requires an OAuth token for authorization, a contact ID as a path parameter, and an organization ID as a query parameter. The response includes a list of addresses with details such as address ID, attention, street address, city, state, ZIP code, country, fax, and phone number.Input Fields
: Input FieldsOutput Fields
: Output Fields
Convert PO to Bill
ID
: get_convert_po_to_billOperation
: writeEntities
: bill, purchase order, vendorSummary
: The 'Convert PO to Bill' API allows users to create a bill for selected purchase orders. It requires the purchase order IDs and organization ID as query parameters. The API uses OAuth for authorization, requiring an 'Authorization' header with a valid token. The response includes details of the created bill, such as bill ID, vendor details, tax information, line items, and payment details. The API is useful for automating the conversion of purchase orders into bills within the Zoho Books platform.Input Fields
: Input FieldsOutput Fields
: Output Fields
List credit note comments & history
ID
: get_credit_note_comments_historyOperation
: readEntities
: comment, credit note, historySummary
: This API retrieves the comments and history of a specific credit note. It requires an OAuth token for authorization and the credit note ID as a path parameter. The organization ID must be provided as a query parameter. The response includes a list of comments with details such as the comment ID, description, the person who commented, and the type of operation performed.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get credit note refund
ID
: get_credit_note_refundOperation
: readEntities
: credit note refund, credit note, customerSummary
: The 'Get credit note refund' API retrieves the refund details of a specific credit note. It requires the credit note ID and the refund ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. The response includes details such as the refund ID, credit note ID, refund date, mode, payment form, reference number, amount, customer name, and a description.Input Fields
: Input FieldsOutput Fields
: Output Fields
List credit note template
ID
: get_credit_note_templateOperation
: readEntities
: credit note, organization, templateSummary
: The 'List credit note template' API retrieves all available credit note PDF templates for a specified organization. It requires an OAuth token for authorization, which should be included in the request headers. The organization ID must be provided as a query parameter. The API responds with a list of templates, each containing the template name, ID, and type. A successful response will have a code of 0 and a message indicating success.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get current running timer
ID
: get_current_running_timerOperation
: readEntities
: project, time entry, customerSummary
: The 'Get current running timer' API retrieves the current running timer for the authenticated user in a specified organization. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes details about the time entry such as the time entry ID, project details, customer details, task details, user details, log times, billing status, and any notes or custom fields associated with the timesheet.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get current user
ID
: get_current_userOperation
: readEntities
: organization, user, roleSummary
: The 'Get current user' API retrieves the details of the current user associated with the specified organization in Zoho Books. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes the user's ID, name, email addresses, status, role, type, and other relevant details.Input Fields
: Input FieldsOutput Fields
: Output Fields
Details of a refund
ID
: get_details_of_a_refundOperation
: readEntities
: refund, vendor payment, accountSummary
: This API retrieves the details of a specific refund for a vendor payment in Zoho Books. It requires the vendor payment ID and the refund ID as path parameters, and the organization ID as a query parameter. The request must include an Authorization header with a valid OAuth token. The response includes details such as the refund ID, vendor payment ID, date, refund mode, reference number, amount, exchange rate, account details, and a description.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get email content of a credit note
ID
: get_email_content_of_a_credit_noteOperation
: readEntities
: email template, credit note, customerSummary
: The 'Get email content of a credit note' API retrieves the email content associated with a specific credit note in Zoho Books. It requires an OAuth token for authorization and the credit note ID as a path parameter. The organization ID is a mandatory query parameter, while the email template ID is optional. If the email template ID is not provided, the default template will be used. The API returns the email content details, including the body, subject, associated email templates, recipient contacts, and sender details.Input Fields
: Input FieldsOutput Fields
: Output Fields
Email history
ID
: get_email_historyOperation
: readEntities
: email history, credit noteSummary
: The 'Email history' API retrieves the email history of a specific credit note. It requires an OAuth token for authorization and the credit note ID as a path parameter. The organization ID must be provided as a query parameter. The API returns a list of email history records, each containing details such as the sender's email, recipient email addresses, subject, and date of the email.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get estimate email content
ID
: get_estimate_email_contentOperation
: readEntities
: email template, estimate, customerSummary
: The 'Get estimate email content' API retrieves the email content for a specific estimate in Zoho Books. It requires an OAuth token for authorization and the estimate ID as a path parameter. The organization ID and email template ID are required query parameters. The response includes the email body, subject, list of email templates, contacts, and other related information. If the email template ID is not provided, the default template associated with the customer is used.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an exchange rate
ID
: get_exchange_rateOperation
: readEntities
: exchange rate, currency, organizationSummary
: This API retrieves the details of an exchange rate associated with a specific currency. It requires an OAuth token for authorization. The request must include the currency ID and exchange rate ID as path parameters, and the organization ID as a query parameter. The response includes a code indicating success or failure, a message, and the exchange rate value.Input Fields
: Input FieldsOutput Fields
: Output Fields
List expense History & Comments
ID
: get_expense_history_commentsOperation
: readEntities
: comment, organization, expenseSummary
: This API retrieves the history and comments of a specific expense in Zoho Books. It requires an OAuth token for authorization and the expense ID as a path parameter. The organization ID must be provided as a query parameter. The response includes a list of comments with details such as comment ID, expense ID, description, the user who commented, and the time of the comment.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an expense receipt
ID
: get_expense_receiptOperation
: readEntities
: receipt, organization, expenseSummary
: The 'Get an expense receipt' API retrieves the receipt attached to a specified expense in Zoho Books. It requires an OAuth token for authorization, and the expense ID must be provided as a path parameter. The organization ID is a required query parameter, and an optional 'preview' query parameter can be used to request a thumbnail of the receipt. The API returns a response with a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Generate payment link
ID
: get_generate_payment_linkOperation
: readEntities
: invoice, transaction, payment linkSummary
: The 'Generate payment link' API generates a payment link for a specified invoice with an expiry date. It requires an OAuth token for authorization and takes several query parameters: 'transaction_id' (the ID of the transaction), 'transaction_type' (the type of transaction, e.g., Invoice), 'link_type' (the type of link, either Private or Public), 'expiry_time' (the expiry date of the link in yyyy-MM-dd format), and 'organization_id' (the ID of the organization). The API returns a response with a code and message indicating success or failure, and if successful, it provides a 'share_link' which is the generated payment link.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get Individual Record Details
ID
: get_individual_record_detailsOperation
: readEntities
: comment, debtor, userSummary
: The 'Get Individual Record Details' API retrieves the details of a specific debtor record from Zoho Books. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the debtor ID as part of the URL and the organization ID as a query parameter. The response includes detailed information about the debtor record, including comments, module fields, and user details. The response body contains a code and message indicating the success of the operation, along with the module record and hash details.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get an invoice attachment
ID
: get_invoice_attachmentOperation
: readEntities
: invoice, attachment, organizationSummary
: The 'Get an invoice attachment' API retrieves the file attached to a specified invoice. It requires an OAuth token for authorization, which should be included in the request headers. The API endpoint requires the invoice ID as a path parameter and the organization ID as a query parameter. An optional query parameter 'preview' can be used to request a thumbnail of the attachment. The response includes a code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
List invoice comments & history
ID
: get_invoice_comments_historyOperation
: readEntities
: comment, invoice, historySummary
: The 'List invoice comments & history' API retrieves the complete history and comments of a specified invoice. It requires an OAuth token for authorization and the invoice ID as a path parameter. The organization ID must be provided as a query parameter. The response includes a list of comments with details such as comment ID, invoice ID, description, commenter details, comment type, operation type, date, time, transaction ID, and transaction type.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get invoice email content
ID
: get_invoice_email_contentOperation
: readEntities
: email template, invoice, customerSummary
: The 'Get invoice email content' API retrieves the email content for a specified invoice. It requires an OAuth token for authorization and the invoice ID as a path parameter. The organization ID is a required query parameter, while the email template ID is optional. If the email template ID is not provided, the default or customer-associated template will be used. The response includes details such as the email body, customer name, subject, and associated documents. It also provides information about the email templates and contacts involved.Input Fields
: Input FieldsOutput Fields
: Output Fields
List invoice templates
ID
: get_invoice_templatesOperation
: readEntities
: invoice, organization, templateSummary
: The 'List invoice templates' API retrieves all invoice PDF templates available for a specified organization. It requires an OAuth token for authorization, which must be included in the request headers. The organization ID must be provided as a query parameter. The API responds with a list of templates, each containing a template name, ID, and type, along with a response code and message indicating the success of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
List items
ID
: get_itemsOperation
: readEntities
:Summary
: The 'List items' API retrieves a list of all active items with pagination support. It requires an OAuth token for authorization and the organization ID as a query parameter. Optional query parameters allow filtering and sorting of items by name, description, rate, tax details, account association, and more. The response includes a list of items with details such as item ID, name, status, rate, tax information, and custom fields, along with pagination context.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get journal
ID
: get_journalOperation
: readEntities
: tax, line item, journalSummary
: The 'Get journal' API retrieves the details of a specific journal entry in Zoho Books. It requires an OAuth token for authorization, the journal entry ID as a path parameter, and the organization ID as a query parameter. The API returns a detailed response containing the journal's ID, entry number, reference number, notes, currency details, journal date, type, VAT treatment, line items, total amounts, taxes, creation and modification times, status, and any custom fields associated with the journal.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get journal list
ID
: get_journal_listOperation
: readEntities
: journalSummary
: The 'Get journal list' API retrieves a list of journals from Zoho Books. It requires an OAuth token for authorization and the organization ID as a query parameter. Optional query parameters include entry_number, reference_number, date, notes, last_modified_time, total, customer_id, vendor_id, filter_by, and sort_column, which allow for filtering and sorting the journal list. The response includes a code, message, and an array of journal objects, each containing details such as journal_id, journal_date, entry_number, reference_number, currency_id, notes, journal_type, entity_type, total, bcy_total, and custom_field.Input Fields
: Input FieldsOutput Fields
: Output Fields
Get last imported statement
ID
: get_last_imported_statementOperation
: readEntities
: statement, transaction, bank accountSummary
: The 'Get last imported statement' API retrieves the details of the most recently imported statement for a specified bank account. It requires an OAuth token for authorization, the bank account ID as a path parameter, and the organization ID as a query parameter. The response includes a list of statements with details such as statement ID, date range, source, and transactions. Each transaction includes information like transaction ID, type, date, customer ID, payee, reference number, amount, and status.Input Fields
: Input FieldsOutput Fields
: Output Fields
List a retainer invoices
ID
: get_list_a_retainer_invoicesOperation
: readEntities
: project, retainer invoice, customerSummary
: The 'List a retainer invoices' API allows users to retrieve a list of retainer invoices with pagination support. It requires an OAuth token for authorization and the organization ID as a query parameter. Optional query parameters include print, sort_column, filter_by, sort_order, and page. The response includes a list of retainer invoices with details such as invoice ID, customer name, status, total amount, and more, along with pagination context.Input Fields
: Input FieldsOutput Fields
: Output Fields
List all Credit Notes
ID
: get_list_all_credit_notesOperation
: readEntities
: item, credit note, customerSummary
: The 'List all Credit Notes' API allows users to retrieve a list of all credit notes associated with a specified organization in Zoho Books. The API requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Optional query parameters include credit note number, date, status, total, reference number, customer name, item name, customer ID, item description, item ID, line item ID, tax ID, filter by status, search text, and sort column. The response includes details of the credit notes such as credit note ID, number, status, reference number, date, total, balance, customer ID, customer name, currency ID, currency code, created time, last modified time, and whether the credit note was emailed.Input Fields
: Input FieldsOutput Fields
: Output Fields
List all Recurring Invoice
ID
: get_list_all_recurring_invoiceOperation
: readEntities
: item, recurring invoice, customerSummary
: This API retrieves the details of all recurring invoices for a specified organization. It requires an OAuth token for authorization and the organization ID as a query parameter. Optional query parameters include recurrence name, item name, item description, customer name, line item ID, item ID, tax ID, notes, start date, end date, customer ID, status, filter by, search text, and sort column. The response includes a list of recurring invoices with details such as invoice ID, recurrence name, customer details, currency, start and end dates, custom fields, billing and shipping addresses, and pagination context.Input Fields
: Input FieldsOutput Fields
: Output Fields
List base currency adjustment
ID
: get_list_base_currency_adjustmentOperation
: readEntities
: exchange rate, base currency adjustment, currencySummary
: The 'List base currency adjustment' API retrieves a list of base currency adjustments for a specified organization. It requires an OAuth token for authorization and the organization ID as a query parameter. Optional query parameters include 'filter_by' to filter the list by date, 'sort_column' to sort the list by various fields, and 'last_modified_time' to search by the last modified time. The response includes a code and message indicating success or failure, and a list of base currency adjustments with details such as adjustment ID, date, exchange rate, currency ID and code, notes, and gain or loss.Input Fields
: Input FieldsOutput Fields
: Output Fields
List bill comments & history
ID
: get_list_bill_comments_historyOperation
: readEntities
: bill, comment, historySummary
: The 'List bill comments & history' API retrieves the complete history and comments of a specified bill. It requires an OAuth token for authorization and the unique identifiers for the bill and organization as input parameters. The API returns a list of comments associated with the bill, including details such as the comment ID, bill ID, description, commenter details, comment type, date, time, operation type, and transaction details.Input Fields
: Input FieldsOutput Fields
: Output Fields
List bill payments
ID
: get_list_bill_paymentsOperation
: readEntities
: bill, vendor, paymentSummary
: The 'List bill payments' API retrieves a list of payments made for a specific bill in Zoho Books. It requires an OAuth token for authorization, the bill ID as a path parameter, and the organization ID as a query parameter. The response includes a list of payments with details such as payment ID, bill ID, vendor information, payment mode, date, amount, and more.Input Fields
: Input FieldsOutput Fields
: Output Fields
List bills
ID
: get_list_billsOperation
: readEntities
: bill, vendor, itemSummary
: The 'List bills' API allows users to retrieve a list of bills with pagination support. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Users can filter and search bills using various query parameters such as bill number, reference number, date, status, description, vendor name, total, vendor ID, item ID, recurring bill ID, purchase order ID, last modified time, and more. The API also supports sorting by columns like vendor name, bill number, date, due date, total, balance, and created time. The response includes a list of bills with details such as bill ID, vendor ID, vendor name, status, bill number, reference number, date, due date, currency information, total amount, balance, and timestamps. Additionally, the response provides pagination context with information about the current page, items per page, and sorting details.Input Fields
: Input FieldsOutput Fields
: Output Fields
List bills credited
ID
: get_list_bills_creditedOperation
: readEntities
: bill, vendor creditSummary
: The 'List bills credited' API retrieves a list of bills to which a vendor credit is applied. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes a list of credited bills with details such as vendor credit ID, bill ID, vendor credit bill ID, date, and bill number.Input Fields
: Input FieldsOutput Fields
: Output Fields
List chart of accounts
ID
: get_list_chart_of_accountsOperation
: readEntities
: organization, transaction, accountSummary
: The 'List chart of accounts' API retrieves a list of all chart of accounts for a specified organization, with options for pagination and filtering. It requires an OAuth token for authorization. The API accepts query parameters such as 'organization_id' (required), 'showbalance', 'filter_by', 'sort_column', and 'last_modified_time' to customize the response. The response includes a list of accounts with details like account ID, name, type, balance, and more.Input Fields
: Input FieldsOutput Fields
: Output Fields
List child expenses created
ID
: get_list_child_expenses_createdOperation
: readEntities
: page context, recurring expense, expenseSummary
: The 'List child expenses created' API retrieves a list of child expenses created from a recurring expense. It requires an OAuth token for authorization. The API supports sorting the expenses by various columns such as next_expense_date, account_name, total, etc. The response includes a list of expenses with details like expense_id, date, account_name, customer_name, total, status, vendor_name, and paid_through_account_name. Additionally, it provides page context information such as the sort column, filter applied, and search text used.Input Fields
: Input FieldsOutput Fields
: Output Fields
List Comments
ID
: get_list_commentsOperation
: readEntities
: comment, transaction, contactSummary
: The List Comments API retrieves recent activities or comments associated with a specific contact in Zoho Books. It requires an OAuth token for authorization and the contact ID as a path parameter. The organization ID must be provided as a query parameter. The response includes a list of comments with details such as comment ID, contact name, commenter details, date, time, and transaction information. Pagination details are also included in the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
List contact persons
ID
: get_list_contact_personsOperation
: readEntities
: contact person, organization, contactSummary
: The 'List contact persons' API retrieves a list of contact persons associated with a specific contact in Zoho Books. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes a list of contact persons with details such as contact person ID, name, email, phone, and other attributes. Pagination details are also provided in the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
List Contacts
ID
: get_list_contactsOperation
: readEntities
: status, company, contactSummary
: The List Contacts API allows you to retrieve a list of contacts with pagination support. It requires an OAuth token for authorization and supports various query parameters for filtering and sorting the contacts. The response includes a list of contacts with details such as contact name, company name, contact type, status, payment terms, currency information, and contact person's details. The pagination context is also provided in the response to navigate through the pages.Input Fields
: Input FieldsOutput Fields
: Output Fields
List credit note refunds
ID
: get_list_credit_note_refundsOperation
: readEntities
: credit note refund, page context, customerSummary
: The 'List credit note refunds' API retrieves a list of all credit note refunds with pagination support. It requires an OAuth token for authorization and the organization ID as a query parameter. Optional query parameters include customer_id to filter refunds by customer and sort_column to sort the list by various fields such as refund_mode, reference_number, date, etc. The response includes a list of credit note refunds with details such as refund ID, credit note ID, date, refund mode, and amounts in base and foreign currencies. Pagination details are also provided in the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
List credits applied
ID
: get_list_credits_appliedOperation
: readEntities
: credit, invoice, organizationSummary
: The 'List credits applied' API retrieves a list of credits that have been applied to a specific invoice. It requires an OAuth token for authorization and takes the invoice ID as a path parameter and the organization ID as a query parameter. The response includes a list of credits with details such as credit note ID, associated invoice ID, credit note number, credited date, and the amount applied.Input Fields
: Input FieldsOutput Fields
: Output Fields
List Currencies
ID
: get_list_currenciesOperation
: readEntities
: currencySummary
: The List Currencies API retrieves a list of currencies configured in the Zoho Books account. It requires an OAuth token for authorization and the organization ID as a query parameter. Optionally, you can filter the currencies to exclude the base currency using the 'filter_by' query parameter. The response includes a list of currencies with details such as currency ID, code, name, symbol, price precision, format, whether it is the base currency, exchange rate, and effective date.Input Fields
: Input FieldsOutput Fields
: Output Fields
List Customer Payments
ID
: get_list_customer_paymentsOperation
: readEntities
: payment, customerSummary
: The 'List Customer Payments' API allows users to retrieve a list of payments made by customers. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Users can filter the payments using various optional query parameters such as customer name, reference number, date, amount, notes, payment mode, and customer ID. The response includes a list of customer payments with details such as payment ID, payment number, invoice number, date, payment mode, amount, and base currency amount.Input Fields
: Input FieldsOutput Fields
: Output Fields
List employees
ID
: get_list_employeesOperation
: readEntities
: page context, organization, employeeSummary
: The 'List employees' API retrieves a list of employees for a specified organization with pagination support. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes a list of employees with their IDs, names, and emails, along with pagination context such as the current page, number of records per page, and applied filters.Input Fields
: Input FieldsOutput Fields
: Output Fields
List estimate comments & history
ID
: get_list_estimate_comments_historyOperation
: readEntities
: comment, estimate, historySummary
: The 'List estimate comments & history' API retrieves the complete history and comments associated with a specific estimate. It requires an OAuth token for authorization and the estimate ID as a path parameter. The organization ID must be provided as a query parameter. The API returns a list of comments, each containing details such as the comment ID, estimate ID, description, commenter details, comment type, date, time, operation type, and transaction details.Input Fields
: Input FieldsOutput Fields
: Output Fields
List Estimate Template
ID
: get_list_estimate_templateOperation
: readEntities
: estimate template, authorization, organizationSummary
: The List Estimate Template API retrieves all estimate PDF templates available for a specified organization in Zoho Books. It requires an OAuth token for authorization and the organization ID as a query parameter. The response includes a list of templates, each with a name, ID, and type.Input Fields
: Input FieldsOutput Fields
: Output Fields
List estimates
ID
: get_list_estimatesOperation
: readEntities
: item, estimate, customerSummary
: The 'List estimates' API allows users to retrieve a list of estimates with pagination support. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Users can filter and search estimates using various optional query parameters such as estimate number, reference number, customer name, total amount, customer ID, item ID, item name, item description, custom fields, expiry date, estimate date, status, and more. The response includes a list of estimates with details such as estimate ID, customer name, status, estimate number, reference number, date, currency, total amount, creation and modification times, and more. The response also includes pagination details.Input Fields
: Input FieldsOutput Fields
: Output Fields
List exchange rates
ID
: get_list_exchange_ratesOperation
: readEntities
: exchange rate, currencySummary
: The 'List exchange rates' API retrieves a list of exchange rates configured for a specific currency. It requires an OAuth token for authorization and accepts query parameters such as 'from_date' to specify the starting date for exchange rate details, 'is_current_date' to filter rates available for the current date, and 'sort_column' to sort the results by a specific column like 'effective_date'. The response includes a list of exchange rates with details such as 'exchange_rate_id', 'currency_id', 'currency_code', 'effective_date', and 'rate'.Input Fields
: Input FieldsOutput Fields
: Output Fields
List Expenses
ID
: get_list_expensesOperation
: readEntities
: expense, vendor, customerSummary
: The List Expenses API allows users to retrieve a list of expenses with pagination support. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Users can filter and sort expenses based on various criteria such as description, reference number, date, status, amount, account name, customer name, vendor name, and more. The response includes a list of expenses with details such as expense ID, date, account name, description, currency, total amounts, billable status, customer details, and more. Pagination details are also provided in the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
List invoice payments
ID
: get_list_invoice_paymentsOperation
: readEntities
: payment, invoice, organizationSummary
: The 'List invoice payments' API retrieves a list of payments made for a specified invoice. It requires an OAuth token for authorization and the invoice ID as a path parameter. The organization ID must be provided as a query parameter. The response includes a list of payments with details such as payment ID, payment number, invoice ID, payment mode, date, amount, and more.Input Fields
: Input FieldsOutput Fields
: Output Fields
List invoices
ID
: get_list_invoicesOperation
: readEntities
: item, invoice, customerSummary
: The 'List invoices' API allows users to retrieve a list of invoices with pagination support. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. The API supports various query parameters to filter and search invoices, such as invoice number, item name, customer name, status, and more. The response includes detailed information about each invoice, such as invoice ID, customer name, status, total amount, balance, and custom fields. The API also provides pagination details in the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
List invoices credited
ID
: get_list_invoices_creditedOperation
: readEntities
: invoice, credit noteSummary
: The 'List invoices credited' API retrieves a list of invoices to which a specific credit note has been applied. It requires an OAuth token for authorization, the credit note ID as a path parameter, and the organization ID as a query parameter. The response includes a success code and message, along with an array of credited invoices, each containing details such as credit note ID, invoice ID, credit note invoice ID, date, invoice number, credit note number, and the credited amount.Input Fields
: Input FieldsOutput Fields
: Output Fields
List items
ID
: get_list_itemsOperation
: readEntities
: item, tax rule, accountSummary
: The 'List items' API retrieves a list of all active items with pagination support. It requires an OAuth token for authorization and the organization ID as a query parameter. Optional query parameters allow filtering and sorting of items by name, description, rate, tax details, account association, and more. The response includes a list of items with details such as item ID, name, status, rate, tax information, and custom fields, along with pagination context.Input Fields
: Input FieldsOutput Fields
: Output Fields
List of transactions for an account
ID
: get_list_of_transactions_for_an_accountOperation
: readEntities
: transaction, account, customerSummary
: This API lists all involved transactions for a given account in Zoho Books. It requires an OAuth token for authorization and the organization ID and account ID as query parameters. Optional query parameters include date range, amount range, account type and status filter, transaction type, and sort column. The response includes a list of transactions with details such as transaction type, status, date, account ID, customer ID, payee, description, entry number, currency, and amounts.Input Fields
: Input FieldsOutput Fields
: Output Fields
List projects
ID
: get_list_projectsOperation
: readEntities
: project, page_context, customerSummary
: The 'List projects' API allows users to retrieve a list of projects with pagination support. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Optional query parameters include 'filter_by' to filter projects by status, 'customer_id' to search projects by customer ID, and 'sort_column' to sort the projects by specified columns. The response includes a list of projects with details such as project ID, name, customer details, status, billing type, rate, and time information, along with pagination context.Input Fields
: Input FieldsOutput Fields
: Output Fields
List purchase orders
ID
: get_list_purchase_ordersOperation
: readEntities
: item, purchase order, vendorSummary
: The 'List purchase orders' API allows users to retrieve a list of purchase orders from Zoho Books. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Users can filter the purchase orders using various optional query parameters such as purchase order number, reference number, date, status, item description, vendor name, total, vendor ID, last modified time, item ID, filter by status, search text, sort column, and custom field. The response includes a list of purchase orders with details such as purchase order ID, vendor ID, vendor name, status, purchase order number, reference number, date, delivery date, currency ID, currency code, price precision, total amount, attachment status, creation time, last modified time, and custom fields.Input Fields
: Input FieldsOutput Fields
: Output Fields
List recurring bills
ID
: get_list_recurring_billsOperation
: readEntities
: recurring bill, currency, vendorSummary
: The 'List recurring bills' API allows users to retrieve a list of recurring bills with pagination. It requires an OAuth token for authorization and the organization ID as a mandatory query parameter. Optional query parameters include recurring bill ID, vendor ID, vendor name, status, recurrence name, currency details, start and end dates, supply details, GST and VAT treatments, and more. The response includes details of each recurring bill such as IDs, vendor information, status, currency, supply details, tax treatments, line items, and custom fields. The API is useful for managing and tracking recurring bills within an organization.Input Fields
: Input FieldsOutput Fields
: Output Fields