ZOHO OAuth setup

Set up Zoho OAuth by registering your app in the ZOHO API Console. Configure API permissions and upload your credentials to Aurinko.

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 [email protected] for assistance.

Creating a ZOHO Project

---

Begin by visiting to the Zoho API Console (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.

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

• 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 for more information.

Congratulations, you’ve just registered your app!

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.

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:

Aurinko Scope	Zoho API permission
Mail.Read	mailScopes("READ")
Mail.ReadWrite	mailScopes("CREATE", "READ", "UPDATE", "DELETE")
Mail.Drafts	mailScopes("CREATE")
Mail.Send	mailScopes("CREATE")

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.

Configure Aurinko to Use Your Zoho OAuth Credentials

---

Log in to the Aurinko portal, select your app, navigate to Settings, and switch to the ZOHO tab.

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

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