Zync Docs
Zoho Connection

Connect Zoho

Create a Zoho API client and connect it to Zync with OAuth.

Zync connects to Zoho with an API client that you create in your own Zoho account. You stay in control: you can revoke the client in Zoho at any time.

In the app

The Connection page has a Setup Help button with a short version of these steps.

Before you start

You need:

  • A Zoho Books or Zoho Inventory organisation, and a Zoho user who can create API clients.
  • Your Zoho region. Look at the address bar when you are signed in to Zoho: zoho.in is India, zoho.com is the US, zoho.eu is Europe, zoho.com.au is Australia and zoho.jp is Japan.

Region domains

Use the row for your region everywhere on this page. A client created in one region does not work with the domains of another.

RegionAPI ConsoleAccounts DomainAPI Domain
Indiahttps://api-console.zoho.inhttps://accounts.zoho.inhttps://www.zohoapis.in
United Stateshttps://api-console.zoho.comhttps://accounts.zoho.comhttps://www.zohoapis.com
Europehttps://api-console.zoho.euhttps://accounts.zoho.euhttps://www.zohoapis.eu
Australiahttps://api-console.zoho.com.auhttps://accounts.zoho.com.auhttps://www.zohoapis.com.au
Japanhttps://api-console.zoho.jphttps://accounts.zoho.jphttps://www.zohoapis.jp

Step 1: Create the API client

  1. Open the Zoho API Console for your region and sign in.

  2. Click Add Client (or GET STARTED the first time).

  3. Choose Server-based Applications.

    Choosing Server-based Applications in the Zoho API Console
  4. Fill in the form:

    • Client Name: anything you will recognise, for example Shopify Sync.
    • Homepage URL: https://zohosync.vercel.app
    • Authorized Redirect URIs: the redirect URI shown under Step 2: Connect to Zoho on the app's Connection page. Use the Copy button there.
  5. Click CREATE.

    The Create New Client form with the homepage URL and redirect URI
  6. Open the Client Secret tab and copy the Client ID and the Client Secret.

    The Client Secret tab showing the Client ID and Client Secret

Step 2: Enter the credentials

In Zync, open Connection. Under Step 1: Zoho API Credentials fill in:

FieldWhat to enter
Zoho Modulebooks for Zoho Books, inventory for Zoho Inventory
Client IDFrom the Zoho API Console
Client SecretFrom the Zoho API Console
Organization IDLeave empty to use your default organisation. Enter an ID only when you have several organisations and want one that is not the default
Accounts DomainFrom the table above
API DomainFrom the table above

Click Save Credentials.

The Connection page with the credential fields, Save Credentials and Connect via OAuth

Finding an organisation ID

In Zoho Books or Zoho Inventory, click your organisation name at the top right and choose Manage Organizations. The ID is listed beside each organisation.

Step 3: Authorise with OAuth

  1. Check that the redirect URI in the Zoho API Console is exactly the one the app shows. If you change it in Zoho, click UPDATE.
  2. In Zync, click Connect via OAuth. A Zoho window opens.
  3. Sign in if asked, review the access request and click Accept.
  4. The window closes and the Connection page reloads.

You now see Connected to Zoho with a green Connected badge, the module you chose and the organisation ID.

The Connected to Zoho card with Test Connection and Disconnect

Zync asks for full access to Zoho Books and Zoho Inventory, because it creates and updates items, contacts, sales orders, invoices, payments and credit notes on your behalf.

Check or end the connection

ButtonWhat it does
Test ConnectionRefreshes the Zoho token and confirms that Zoho accepts it
DisconnectRemoves the stored tokens and stops listening for Shopify events. Your settings and the links on your records are kept, so you can connect again later

Changing module, region or organisation

Click Disconnect, change the credentials under Step 1, save, then connect again.

Changing organisation after you have synced

The Zoho IDs saved on your Shopify products, customers and orders belong to the organisation you synced with. If you connect a different organisation, those links point at records that do not exist there. Talk to support before you switch a store that has already synced.

Next step

Map your Shopify locations to Zoho warehouses.