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. Keep the Client ID and Client Secret private and confirm which Zoho region belongs to your organization. Zoho Books' OAuth guide explains the vendor's authorization and organization context.
Steps to connect Zoho Books
- Open Settings → Integrations in Optiply and wait for the sources to load.
- Choose Add a source, select Zoho Books, then choose Next. Select this source rather than Zoho Inventory.
- Enter the Organization ID and review the displayed filters below. Use identifiers for your organization and warehouses rather than copying example values.
- 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.
- 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
invoicedorpartially_invoiced, or whose order status isclosed. 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. 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.