# 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="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2Fj63XA9rq7uNkfCmlEYqh%2Fimage.png?alt=media&#x26;token=ccaed9c1-f51c-4278-9ea3-551fa1552e7a" 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="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2F0I8jxB00OG0YY5goWg36%2FMonosnap%20Zoho%20API%20Console%202024-11-07%2019-13-22.png?alt=media&#x26;token=2595baa4-5c74-4685-8d8b-e9a49706f2c0" alt="" width="563"><figcaption></figcaption></figure>

Congratulations, you’ve just registered your app!

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FVkwOsN0tcZHbX4wILsf2%2FMonosnap%20Zoho%20API%20Console%202024-11-07%2019-15-32.png?alt=media&#x26;token=e6311151-d1d3-4a4d-b549-d5e961b0678a" 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="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FiebCWf9phR3PB5uRg4Hm%2FMonosnap%20Zoho%20API%20Console%202025-04-23%2016-12-33.png?alt=media&#x26;token=76da597c-3259-4f48-af14-d98c1cb11a5d" 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="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FDc4w04LS6YCV1RiuX9Rh%2FMonosnap%20Zoho%20API%20Console%202024-11-07%2019-19-08.png?alt=media&#x26;token=49037209-22c7-4025-9162-345f40114252" 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="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FBfMpHOtkGGf2PeDozycu%2FMonosnap%20Settings%202024-11-07%2018-49-30.png?alt=media&#x26;token=73d62107-7015-4dda-9497-800d18c607c5" 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!**