# Zoho Books: set up your Optiply connection

Connect **Zoho Books** from **Settings → Integrations** by selecting the source, entering the intended **Organization ID** and completing Zoho authorization. Review sales-order, salesperson and warehouse filters in the connection form before authorizing. You can start configuration yourself; use Optiply Support for connection-specific application details or when the screen offers **Contact us**.

## Before you connect Zoho Books

Use the intended Optiply account and a user allowed to change integration settings. Have access to the correct Zoho organization. If your connection needs your own application credentials, first [register a server-based Zoho application](/article/zoho-creating-a-server-based-application-in-zoho-api-console). Keep the **Client ID** and **Client Secret** private and confirm which Zoho region belongs to your organization. [Zoho Books' OAuth guide](https://www.zoho.com/books/api/v3/oauth/) explains the vendor's authorization and organization context.

## Steps to connect Zoho Books

1. Open **Settings → Integrations** in Optiply and wait for the sources to load.
2. Choose **Add a source**, select **Zoho Books**, then choose **Next**. Select this source rather than Zoho Inventory.
3. Enter the **Organization ID** and review the displayed filters below. Use identifiers for your organization and warehouses rather than copying example values.
4. Choose **Connect** when offered and complete the Zoho authorization popup. Accept access only for the intended organization. If **Contact us** appears instead, request help there; the path offered depends on source availability and your account's integration limit.
5. Return to **Settings → Integrations**, find **Zoho Books** and check its **Connected** label. Expand the source and open **Import jobs** to review the import separately.

## Fields in the Zoho Books connection form

- **Organization ID:** identifies the Zoho organization to read. Use the intended organization, not an item or warehouse ID.
- **Warehouse ID(s):** limits warehouse selection. Enter multiple IDs separated by commas, without spaces; leave the field as agreed for your connection when no selection is needed.
- **Connect:** starts the displayed connection flow. **Contact us** requests assistance when direct connection is unavailable.
- **Connected:** identifies a linked source. Check **Import jobs** separately for the import result.
- **Pull all sales orders:** when disabled, Books keeps orders whose status is `invoiced` or `partially_invoiced`, or whose order status is `closed`. With the option enabled, that completed-order filter is not applied.
- **Salesperson ID:** excludes sales orders for the listed salesperson IDs. Separate multiple IDs with commas, without spaces.

## What you see when Zoho Books connection worked

The intended source is listed as **Connected**. Its **Import jobs** tab shows job history; refresh that list to check the latest result. Authorization and a linked source are separate from a completed import, so compare expected records after checking the job result.

## Limits of connecting Zoho Books

Zoho Books and Zoho Inventory are separate sources with different order filters and mappings. Connecting one does not configure the other. Filters affect which records can enter the import; this setup does not promise a fixed synchronization-completion time.

## If the Zoho Books connection did not work

Wait while **Add a source** is disabled during loading. If the source is absent, the authorization popup fails, the organization is unclear or expected records are missing after a job, [contact Optiply Support](/support). Include the connector name, the step or job that failed, the time and a description with credentials removed. Ask Support for the approved secure channel before transferring application credentials; never paste a Client Secret, access token or refresh token into an ordinary message or screenshot. Keep the current connection until Support confirms whether it needs reconnecting.

## Related articles on Zoho Books setup and data

- [Register the Zoho application](/article/zoho-creating-a-server-based-application-in-zoho-api-console)
- [Zoho Books field mappings](/article/integrations-data-mappings-public-zoho-books)
- [Zoho Inventory setup](/article/zoho-inventory-set-up-and-connection)
