🔗 How to Set Up the Zoho Integration in illumine

Connecting Zoho Books, mapping your accounts, and avoiding duplicate records on first sync

illumine's Zoho integration keeps students, fee components, invoices, payments, and credit notes synchronised with Zoho Books automatically. This guide covers everything needed to connect Zoho for the first time, map your accounts and existing records correctly, and then use the ongoing sync status indicators and manual sync option day-to-day.

The first time you visit, you'll see the Zoho Integration intro screen. Click Connect to Zoho. You'll be redirected to Zoho to sign in and authorize illumine — this is a one-time OAuth step. Once authorized, you're returned to illumine with the connection active.

Fig. 3 — The Zoho Integration intro screen with the Connect to Zoho button

If your Zoho account has more than one organization, start by selecting the correct one from the Choose Organization screen — the Zoho connection and all mappings are set up per organization.

Fig. 1 — Choose Organization screen

Now you will be redirected to the Zoho Integration homepage. This is your control center for the integration - it shows an overview card, plus a count of every entity type (Students, Fee Components, Invoices) synced between illumine and Zoho.

Fig. 2 — The Zoho Integration overview page, with entity counts and the Actions menu

Before any data syncs, tell illumine which Zoho accounts to use by default. Under Invoices, set the Payment Account (used when syncing payments) and the Line Item Account (used as the default account for invoice line items).

Fig. 4 — Choosing a default Payment Account from your Zoho chart of accounts

Click Configure next to Payment Method. In the Configure Payment Methods dialog, map each illumine payment method (Cash, Card, Bank Transfer, Cheque, Payment Gateway, Tabby, etc.) to the matching account in Zoho, so payments sync to the right ledger. Click Save when done.

Fig. 5 — Mapping illumine payment methods to Zoho accounts

If your Zoho organization uses Locations (common for multi-branch nurseries), set Location Mapping so invoices from each illumine center post to the correct Zoho location. Click the field and search for your center's matching Zoho location from the list.

Fig. 6 — Searching and selecting the matching Zoho location for a center

Fig. 7 — Invoice settings with Payment Account, Line Item Account, Payment Method, and Location Mapping all configured

⚠ Complete all account and location mappings before enabling sync. Changing these later won't retroactively fix records that already synced with the wrong account.

If you already have student/customer records in Zoho from before connecting illumine, map them to your existing illumine students first. Otherwise, the initial sync will create brand-new duplicate customer records in Zoho instead of matching your existing ones.

From the Zoho Integration page, click Explore next to Student. Switch between the Mapped and Unmapped tabs to see which illumine students already have a matching Zoho contact, and which still need to be linked.

For each row, use the Name as seen in Zoho field to search for and select the corresponding existing contact in Zoho. illumine will link the two records instead of creating a new one on the next sync.

Fig. 8 — Student Mapping screen, linking illumine students to their existing Zoho contacts

Once every student that has an existing Zoho record has been matched, click Save in the top-right corner. Any students left unmapped will simply create new customer records in Zoho on their first sync — which is fine for genuinely new students.

⚠ Do the student mapping once, right after connecting. It's the single most important step for avoiding duplicate customer records in Zoho.