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.
Last updated
Aurinko API
Set up Zoho OAuth by registering your app in the ZOHO API Console. Configure API permissions and upload your credentials to Aurinko.
Last updated
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 for assistance.
Begin by visiting to the (use 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
Congratulations, you’ve just registered your app!
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.
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:
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.
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.
Copy-paste your Zoho OAuth Client ID and Client Secret, then click Save.
You’re now ready to start connecting Zoho accounts to Aurinko!
Enter the Redirect URI where Zoho will redirect users after they authorize access. This URL is essential for completing the OAuth flow. Read for more information.
Log in to the , select your app, navigate to Settings, and switch to the ZOHO tab.
