# ZOHO OAuth setup

To connect Zoho accounts to Aurinko through OAuth2 authentication, you'll need to register your application in Zoho's API Console. Afterward, you can configure Aurinko to use your Zoho application credentials. If you encounter any issues registering your application, reach out to [support@aurinko.io](mailto:mailto:support@aurinko.io) for assistance.

### **Creating a ZOHO Project**

***

Begin by visiting to the [Zoho API Console](https://api-console.zoho.com/) (use <https://api-console.zoho.eu/> if you're based in Europe). Sign in with your Zoho account, or create one if you don't already have it.

Click **Add Client** (or similar option based on your interface) and select the "Server-Based Application" Client Type.

<div data-full-width="true"><figure><img src="/files/yMODE91HMVulNzsIXxLb" alt=""><figcaption></figcaption></figure></div>

You’ll see a registration form:

* Set **Client Type** to **Server-Based Application**.
* Set **Name** to your app’s name (this name will be visible to users).
* Enter **Homepage URL**&#x20;
* Enter the **Redirect URI** where Zoho will redirect users after they authorize access. This URL is essential for completing the OAuth flow. Read [this article](https://docs.aurinko.io/~/changes/yv1VO4PXj9jgHpMsK3Io/authentication/authorized-return-urls) for more information.

<figure><img src="/files/g7chHiA6Xjk5OikjNWeY" alt="" width="563"><figcaption></figcaption></figure>

Congratulations, you’ve just registered your app!

<div data-full-width="true"><figure><img src="/files/Gs8YwExSMwjxK7T6s01F" alt=""><figcaption></figcaption></figure></div>

### Use the Same OAuth Credentials Across All Data Centers

***

To ensure your Zoho integration works globally, go to **Zoho Developer Console → Settings**, and make sure to enable the checkbox: **“Use the same OAuth credentials for all data centers”**.

This setting allows your extension or integration to function seamlessly across different Zoho domains (e.g., `.com`, `.eu`, `.in`), using a single set of OAuth credentials.\
Without this option enabled, your app may only work within the region where it was created.

<figure><img src="/files/oz3SPLVPmjJaBiPxqHlU" alt=""><figcaption></figcaption></figure>

### **Specifying API Permissions (Scopes)**

***

Next, set the required API permissions (Scopes) for your application.

In the **Scope** section, choose the necessary permissions based on the features you want to access. Here’s an example of how Zoho Scopes align with Aurinko’s permissions:

<table><thead><tr><th width="242">Aurinko Scope</th><th>Zoho API permission</th></tr></thead><tbody><tr><td><code>Mail.Read</code></td><td><code>mailScopes("READ")</code></td></tr><tr><td><code>Mail.ReadWrite</code></td><td><code>mailScopes("CREATE", "READ", "UPDATE", "DELETE")</code></td></tr><tr><td><code>Mail.Drafts</code></td><td><code>mailScopes("CREATE")</code></td></tr><tr><td><code>Mail.Send</code></td><td><code>mailScopes("CREATE")</code></td></tr></tbody></table>

Add all required permissions for your application’s functionality.

### **Creating OAuth Credentials**

***

Head to **Client Secret** in your Zoho application and click **Generate** to create a new client secret.

Copy the client secret and save it securely, as you won’t be able to retrieve it later.

Finally, copy the **Client ID** and **Client Secret** from the Zoho app page.

<figure><img src="/files/PmXjlToBuL1Ar7au48WN" alt="" width="563"><figcaption></figcaption></figure>

### **Configure Aurinko to Use Your Zoho OAuth Credentials**

***

Log in to the [Aurinko portal](https://app.aurinko.io/), select your app, navigate to **Settings**, and switch to the **ZOHO** tab.<br>

<div data-full-width="true"><figure><img src="/files/HMN4lTLh8Tl6sEshIR8L" alt=""><figcaption></figcaption></figure></div>

Copy-paste your Zoho OAuth **Client ID** and **Client Secret**, then click **Save**.

**You’re now ready to start connecting Zoho accounts to Aurinko!**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aurinko.io/authentication/zoho-oauth-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.