Documentation Index
Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
🚀 Quickstart
🧑💻 OAuth app setup
🔗 Useful links
🚨 API gotchas
Create an integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Zoho Recruit. Nango doesn’t provide a test OAuth app for Zoho Recruit yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango. Authorize Zoho Recruit
Go to Connections -> Add Test Connection -> Authorize, then log in to Zoho Recruit. Later, you’ll let your users do the same directly from your app. Call the Zoho Recruit API
Let’s make your first request to the Zoho Recruit API (retrieves a list of users). Replace the placeholders below with your secret key, integration ID, and connection ID:curl "https://api.nango.dev/proxy/v2/users" \
-H "Authorization: Bearer <NANGO-SECRET-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>"
Install Nango’s backend SDK with npm i @nangohq/node. Then run:import { Nango } from '@nangohq/node';
const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
const res = await nango.get({
endpoint: '/v2/users',
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>'
});
console.log(JSON.stringify(res.data.users, null, 2));
Next step: Embed the auth flow in your app to let your users connect their Zoho Recruit accounts. Access the Zoho API Console
Create a new client
- In the API Console, click on the + ADD CLIENT button and select Server-based Applications as your client type.
- Fill in all the required information. For Authorized Redirect URIs enter
https://api.nango.dev/oauth/callback
- Click Create to register your client. You will then receive a Client ID and Client Secret, which are required to configure your integration in Nango.
Configure Multi-DC
- On the Settings tab, check the option to use the same OAuth credentials for all data centers, this enables you to handle users from different regions
Common Scopes
| Scope | Description |
|---|
ZohoRecruit.users.ALL | Full access to user-related data and operations. |
ZohoRecruit.org.ALL | Full access to organization-level data and configurations. |
ZohoRecruit.modules.submission.ALL | Full access to submission module (create, read, update, delete). |
ZohoRecruit.modules.notes.READ | Read-only access to notes in modules. |
ZohoRecruit.settings.profiles.READ | Read-only access to user profiles and related settings. |
ZohoRecruit.modules.assessment.ALL | Full access to assessment modules (create, read, update, delete). |
-
Zoho uses datacenter-specific URLs for authentication. Make sure to use the correct datacenter domain extension (
com, eu, in, com.cn, com.au) based on where your user’s account is registered.
-
For production applications, consider implementing multi-datacenter support to handle users from different regions.
-
For specific scopes, refer to the API documentation pages to find the exact scopes needed per API and per method.
