> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Zoho Books connector

- Connector: `appmixer.zoho.books`
- Version: 1.3.0
- Components: 23 (2 triggers, 21 actions)

Zoho Books is online accounting software that manages your finances, automates business workflows, and helps you work collectively across departments.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/zoho/books>
- Download package: <https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

**Auth URL:** <https://accounts.zoho.com/oauth/v2/auth?access_type=offline&prompt=consent>

**Scopes:**

- `ZohoBooks.settings.READ`

## Triggers (2)

- [New Contact](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.NewContact.md) (`appmixer.zoho.books.NewContact`): Triggers when a new contact (customer or vendor) is created in Zoho Books. Additional scopes: `ZohoBooks.contacts.READ`.
- [New Invoice](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.NewInvoice.md) (`appmixer.zoho.books.NewInvoice`): Triggers when a new invoice is created in Zoho Books, or optionally when an invoice is created or updated (e.g. sent, paid or voided). Additional scopes: `ZohoBooks.invoices.READ`.

## Actions (21)

- [Create Contact](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.CreateContact.md) (`appmixer.zoho.books.CreateContact`): Create a contact with given information. Additional scopes: `ZohoBooks.contacts.CREATE`.
- [Add Attachment To Invoice](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.AddAttachmentToInvoice.md) (`appmixer.zoho.books.AddAttachmentToInvoice`): Attach a file to an invoice. Additional scopes: `ZohoBooks.invoices.CREATE`.
- [Create Estimate](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.CreateEstimate.md) (`appmixer.zoho.books.CreateEstimate`): Create an estimate (quote) for a customer in Zoho Books. Additional scopes: `ZohoBooks.estimates.CREATE`.
- [Create Invoice](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.CreateInvoice.md) (`appmixer.zoho.books.CreateInvoice`): Create an invoice for your customer. Additional scopes: `ZohoBooks.invoices.CREATE`.
- [Create Item](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.CreateItem.md) (`appmixer.zoho.books.CreateItem`): Create a product or service item in Zoho Books that invoice, estimate and sales order line items can refer to. Additional scopes: `ZohoBooks.settings.CREATE`.
- [Create Payment](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.CreatePayment.md) (`appmixer.zoho.books.CreatePayment`): Record a customer payment in Zoho Books and apply it to one or more invoices. Additional scopes: `ZohoBooks.customerpayments.CREATE`.
- [Create Sales Order](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.CreateSalesOrder.md) (`appmixer.zoho.books.CreateSalesOrder`): Create a sales order for a customer in Zoho Books. Additional scopes: `ZohoBooks.salesorders.CREATE`.
- [Delete Contact](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.DeleteContact.md) (`appmixer.zoho.books.DeleteContact`): Delete an existing contact (customer or vendor). Contacts with transactions (invoices, payments, ...) cannot be deleted. Additional scopes: `ZohoBooks.contacts.DELETE`.
- [Delete Invoice](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.DeleteInvoice.md) (`appmixer.zoho.books.DeleteInvoice`): Delete an existing invoice. Invoices which have payment or credits note applied cannot be deleted. Additional scopes: `ZohoBooks.invoices.DELETE`.
- [Find Invoices](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.FindInvoices.md) (`appmixer.zoho.books.FindInvoices`): Find invoices in Zoho Books by customer, status, invoice number, reference number, date range or search text. Returns up to 200 invoices, newest first. Additional scopes: `ZohoBooks.invoices.READ`.
- [Get Invoice](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.GetInvoice.md) (`appmixer.zoho.books.GetInvoice`): Get the details of an invoice. Additional scopes: `ZohoBooks.invoices.READ`.
- [List Chart Of Accounts](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.ListChartOfAccounts.md) (`appmixer.zoho.books.ListChartOfAccounts`): List all chart of accounts along with pagination. Additional scopes: `ZohoBooks.accountants.READ`.
- [List Contacts](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.ListContacts.md) (`appmixer.zoho.books.ListContacts`): List all contacts with pagination. Additional scopes: `ZohoBooks.contacts.READ`.
- [List Organizations](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.ListOrganizations.md) (`appmixer.zoho.books.ListOrganizations`): In Zoho Books, your business is termed as an organization. If you have multiple businesses, you simply set each of those up as an individual organization. Each organization is an independent Zoho Books Organization with it’s own organization ID, base currency, time zone, language, contacts, reports, etc.
- [List Projects](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.ListProjects.md) (`appmixer.zoho.books.ListProjects`): List all projects with pagination. Additional scopes: `ZohoBooks.projects.READ`.
- [List Journals](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.ListJournals.md) (`appmixer.zoho.books.ListJournals`): Get journal list. Additional scopes: `ZohoBooks.accountants.READ`.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.MakeApiCall.md) (`appmixer.zoho.books.MakeApiCall`): Performs an arbitrary authorized API call to the Zoho Books API. Additional scopes: `ZohoBooks.fullaccess.all`.
- [Mark As Draft](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.MarkAsDraft.md) (`appmixer.zoho.books.MarkAsDraft`): Mark a voided invoice as draft. Additional scopes: `ZohoBooks.invoices.CREATE`.
- [Mark As Sent](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.MarkAsSent.md) (`appmixer.zoho.books.MarkAsSent`): Mark a draft invoice as sent. Additional scopes: `ZohoBooks.invoices.CREATE`.
- [Update Invoice](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.UpdateInvoice.md) (`appmixer.zoho.books.UpdateInvoice`): Update an existing invoice. To delete a line item just remove it from the line_items list. Additional scopes: `ZohoBooks.invoices.UPDATE`.
- [Void Invoice](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.VoidInvoice.md) (`appmixer.zoho.books.VoidInvoice`): Mark an invoice status as void. Upon voiding, the payments and credits associated with the invoices will be unassociated and will be under customer credits. Additional scopes: `ZohoBooks.invoices.CREATE`.

## Changelog

### 1.3.0

- Added CreatePayment: record a customer payment and apply it to one or more invoices.
- Added FindInvoices: search invoices by customer, status, invoice number, reference number, invoice date range or search text.
- Added CreateEstimate, CreateSalesOrder and CreateItem.
- Added NewContact polling trigger, optionally limited to customers or vendors.
- NewInvoice: new Events option "Created or updated" also fires when an invoice changes (sent, paid, overdue, void or edited). The default stays "Created".
- DeleteContact: the description now says it deletes a contact (it described deleting an invoice).

### 1.2.4

- Security: upgraded form-data to 4.0.6 (predictable multipart boundary, CRLF injection in field names and filenames).

### 1.2.3

- Security: upgraded moment to 2.31.0 (medium advisory).

### 1.2.2

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.2.1

- Accounts in the Canada, Japan, Saudi Arabia, United Kingdom, United Arab Emirates and Singapore data centers can be connected. Connecting a Canada account used to fail with "Invalid access token": the region was not recognized, so the authorization code was exchanged at accounts.zoho.com and the API was called at www.zohoapis.com. The connector now uses the accounts server Zoho names in the redirect callback and the API host from the token response (`api_domain`), both checked against the known Zoho data centers. Existing accounts keep working without reconnecting.
- An unknown data center region is reported instead of silently falling back to the US data center.
- Connecting an account through the Auth Hub no longer fails with "Missing region: undefined." The data center is found by asking Zoho - the code exchange and the profile request try the data centers until one accepts the authorization code or the access token - instead of being remembered from the redirect callback, which in the Auth Hub runs as a separate request, possibly in another process. Token refresh through the Auth Hub, which does not know the account's data center either, finds it the same way.

### 1.2.0

- Added NewInvoice polling trigger.
- Fixed intermittent "Parse Error: Expected HTTP/" (HPE_INVALID_CONSTANT) failures in components that read from Zoho. Every GET request was sent with an empty JSON body ({}), which Zoho does not read; on a reused connection those stray bytes corrupted the next response. GET and HEAD requests are now sent without a body.
- A refused OAuth token request is reported instead of being stored. Zoho answers with HTTP 200 and an `error` in the body, so a failed token refresh used to leave the account holding an empty access token: it kept looking connected and every later call failed with an unrelated "Access token not found". An account without a refresh token now says so as well.

### 1.1.0

- Added MakeApiCall component for performing arbitrary authorized API calls to the Zoho Books API.

### 1.0.4

- Aligned CreateContact schema field names with inspector inputs for validation.

### 1.0.3

- Improved error message when using Zoho account without organization.

### 1.0.0

- Initial version
