Zoho Books and HubSpot integration

What moves between them

Customer and invoice data flows from Zoho Books into HubSpot on a configurable schedule. Zoho Books Contacts (customers) are mapped to HubSpot companies, with customer name, email, and billing address synced. Zoho Books invoices are mapped to HubSpot invoice records with invoice number, due date, total amount, and currency. Zoho Books invoice line items are mapped to HubSpot line items and associated with the invoice. Customer payments from Zoho Books are recorded in HubSpot as payment records associated with the invoice. The sync is one-way: ml-connector reads from Zoho Books and writes to HubSpot. Invoices and customers updated in Zoho Books are refreshed in HubSpot on the next sync cycle.

How ml-connector handles it

ml-connector stores the Zoho Books OAuth2 refresh token encrypted and periodically exchanges it for a new access token, routing all API calls to the regional base URL determined by the region field in the OAuth token response. It stores the HubSpot Private App token encrypted and presents it as a Bearer token on each request. On every sync, ml-connector polls Zoho Books invoice and contact lists with offset-based pagination, retrieves the current list from HubSpot, and applies an upsert: if a customer or invoice already exists in HubSpot, it updates the record; if not, it creates it. Zoho Books rate limits are 100 requests per minute globally, so ml-connector monitors response headers and backs off with exponential jitter when a 429 is returned. Zoho Books invoices may include multiple line items; ml-connector creates or updates a line item record in HubSpot for each. Because HubSpot invoices require associations to contacts, ml-connector first ensures the customer is synced to HubSpot as a company and contact, then associates the invoice to that contact. Every record carries a full audit trail and can be replayed if a downstream HubSpot write fails.

A real-world example

A mid-sized B2B SaaS company runs Zoho Books for billing and accounting and uses HubSpot for sales pipeline and customer relationship management. Before the integration, the sales team had no visibility into which deals had invoiced, which invoices were overdue, or customer payment history. The accounting team manually exported customer and invoice data from Zoho Books weekly and imported it into a spreadsheet to track aging. With Zoho Books and HubSpot connected, every new invoice syncs automatically to HubSpot as a record on the contact, and payment status updates in real-time. Sales managers can now see customer lifetime value and payment history in HubSpot deals. Account managers know which invoices are past-due and can follow up immediately. The weekly manual export is gone, and data stays current throughout the sales cycle.

What you can do

• •Sync Zoho Books customers into HubSpot as company and contact records with name, email, and billing address.
• •Map Zoho Books invoices to HubSpot invoice records with invoice number, due date, amount, and currency.
• •Create HubSpot line items for each line in a Zoho Books invoice and associate them with the invoice.
• •Record Zoho Books customer payments in HubSpot and associate them with the corresponding invoice.
• •Route all Zoho Books API calls to the correct regional URL and handle the 100-request-per-minute rate limit with automatic backoff and retry.

Questions

Which direction does data move between Zoho Books and HubSpot?

Data flows from Zoho Books into HubSpot. ml-connector polls Zoho Books invoices and customers on a schedule you set and pushes them into HubSpot as invoices, companies, and contacts. Payments are synced from Zoho Books to HubSpot as payment records. HubSpot records are not synced back to Zoho Books.

How does ml-connector handle Zoho Books regional base URLs?

Zoho Books returns the customer's region (US, EU, India, Australia, Japan, Canada, China, Saudi Arabia) in the OAuth2 token response. ml-connector extracts that region, routes all API calls to the matching regional base URL, and updates the route if the region changes. This ensures every request hits the correct Zoho data center.

What happens when HubSpot invoice write is still in beta?

HubSpot invoice support is in public beta as of January 2026. ml-connector creates and updates invoice records according to the current HubSpot API contract and will adapt if the beta API contract changes. If your team uses HubSpot on a plan that excludes invoices, ml-connector can still sync customer data; contact support to customize the flow.