Skip to content
← Back to Command · Connectors

Command · Connector setup

Set up the Zoho Connector

Connect raia Command to Zoho using a self-client OAuth connection. A single connection can import content from Zoho Desk, Zoho Projects, Zoho CRM, and Zoho Books.

Video walkthrough is available in English.

01

Overview

The Zoho connector allows you to import content from Zoho Desk, Zoho Projects, Zoho CRM, and Zoho Books into raia Command.

You can select only the Zoho products your organization uses. raia Command will automatically generate the OAuth scopes required for the selected products.

Before starting, make sure you know which Zoho data center hosts your account.

Use the correct Zoho data center

Your Zoho API Console must match the region where your Zoho account is hosted. For example, United States accounts normally use .com, European accounts use .eu, Indian accounts use .in, and Australian accounts use .com.au. A mismatched data center will prevent Zoho from authorizing the connection.
02

Open the Zoho connector

  1. 01

    Log in to raia Command.

  2. 02

    Open Connectors from the left-hand menu.

  3. 03

    Select Zoho.

  4. 04

    Stay on the Setup & Import tab.

  5. 05

    Click Add connection.

The Agent Access (MCP) tab is used for agent tools and is not required for a standard content import.

03

Create a Zoho Self Client

  1. 01

    In the connection form, select the data center region that matches your Zoho account.

  2. 02

    Click Open Zoho API Console.

  3. 03

    In the Zoho API Console, click Get Started.

  4. 04

    Select Self Client.

  5. 05

    Create the client.

Zoho will provide a Client ID and Client Secret. Keep this page open because both values will be entered in raia Command.

04

Select the Zoho products

Return to the connection form in raia Command.

Select the products your organization currently uses:

  • Zoho Desk
  • Zoho Projects
  • Zoho CRM
  • Zoho Books

As products are selected, raia Command automatically creates the required OAuth scope list.

Select only licensed products

Do not select a Zoho product that is not enabled for your account. Including scopes for an unavailable product may cause Zoho to reject the authorization request with an INVALID_SCOPE error.

Click Copy beside the generated scope list.

05

Generate the grant code

  1. 01

    Return to the Zoho API Console.

  2. 02

    Open the Generate Code tab.

  3. 03

    Paste the scope list copied from raia Command.

  4. 04

    Set Time Duration to 10 minutes.

  5. 05

    Enter an optional description, such as raia Command Zoho connection.

  6. 06

    Click Create.

  7. 07

    Copy the generated grant code.

The grant code expires after 10 minutes

The generated grant code is single-use and expires after 10 minutes. Copy it and complete the connection in raia Command immediately.
06

Complete the connection

Return to raia Command and enter:

  • Data center region
  • A descriptive label
  • Client ID
  • Client Secret
  • Generated grant code

The label can be the company name, Zoho account name, or a description such as Production Zoho Desk and CRM.

Click Connect.

raia Command will exchange the temporary grant code for the authorization tokens required to maintain the connection.

07

Configure an import

After the connection is created, click New import.

The available selections depend on the Zoho product:

  • Zoho Desk: select a department.
  • Zoho Projects: select a portal and project.
  • Zoho Books: select an organization.
  • Zoho CRM: no additional organizational selection is required.

Select the destination project and folder in raia Command.

The destination folder must already exist under the appropriate project.

Start the import. raia Command will display the sync status and the number of imported records when the process is complete.

08

Verify the connection

Confirm that:

  1. 01

    The Zoho connection appears as connected.

  2. 02

    The appropriate departments, portals, projects, or organizations can be selected.

  3. 03

    A test import completes successfully.

  4. 04

    The imported content appears in the selected raia Command folder.

09

Related