Configuring Zoho Recruit as a Source
In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Zoho Recruit option from the list of connectors. Click Next and you’ll be prompted to add your access.1. Add account access
You’ll need to provide OAuth2 credentials to authorize Nekt to access your Zoho Recruit data. The following configurations are available:- Client ID: The OAuth2 Client ID from your Zoho Developer Console. You can create one by registering a Server-based Application in the Zoho API Console.
- Client Secret: The OAuth2 Client Secret associated with your Client ID.
- Refresh Token: The OAuth2 Refresh Token generated for your Zoho Recruit application. This token is used to obtain new access tokens automatically.
-
Zoho Domain (optional, default:
com): The Zoho domain suffix matching your account region. Usecomfor US,eufor Europe,infor India,com.aufor Australia, orjpfor Japan. - Start Date (optional): The earliest date from which records will be synced incrementally.
2. Select streams
Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. You can select entire groups of streams or pick specific ones.Tip: The stream can be found more easily by typing its name.Select the streams and click Next.
3. Configure data streams
Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table (which will effectively contain the fetched data) and the type of sync.- Layer: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
- Folder: a folder can be created inside the selected layer to group all tables being created from this new data source.
- Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix to all tables at once and make this process faster!
- Sync Type: you can choose between INCREMENTAL and FULL_TABLE.
- Incremental: every time the extraction happens, we’ll get only the new data, which is good if you want to keep every record ever fetched.
- Full table: every time the extraction happens, we’ll get the current state of the data, which is good if you don’t want to have deleted data in your catalog.
4. Configure data source
Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). Optionally, you can define some additional settings:- Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource here.
- Determine when to execute an Additional Full Sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
5. Check your new source
You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.Streams and Fields
Below you’ll find all available data streams from Zoho Recruit and their corresponding fields:Candidates
Candidates
Records of individuals who have applied or been sourced for job positions.Key Fields:
id- Unique identifier for the candidateFirst_Name- Candidate’s first nameLast_Name- Candidate’s last nameEmail- Candidate’s email addressMobile- Mobile phone numberPhone- Phone number
Current_Employer- Current employer nameCurrent_Job_Title- Current job titleExperience_in_Years- Total years of experienceCurrent_Salary- Current salaryExpected_Salary- Expected salarySkill_Set- Skills and competenciesHighest_Qualification- Highest educational qualification
City- CityState- State or provinceCountry- CountryZip_Code- Postal codeStreet- Street address
Source- How the candidate was sourcedCandidate_Status- Current status in the pipelineCandidate_Stage- Current stage in the recruitment processIs_Locked- Whether the record is lockedIs_Unqualified- Whether the candidate is marked as unqualified
Website- Personal websiteLinkedIn- LinkedIn profileTwitter- Twitter handle
Created_Time- Record creation timestampModified_Time- Last modification timestampCreated_By- User who created the recordModified_By- User who last modified the recordOwner- Record owner
Job Openings
Job Openings
Active and historical job positions within your organization or client companies.Key Fields:
id- Unique identifier for the job openingPosting_Title- Title of the job postingJob_Opening_Name- Name of the job openingNumber_of_Positions- Number of open positionsJob_Opening_Status- Current status (e.g., Open, Closed)Job_Type- Type of employment (e.g., Full-time, Part-time)
Industry- Industry sectorDepartment_Name- Department nameWork_Experience- Required work experienceSalary- Salary rangeDate_Opened- Date the position was openedTarget_Date- Target fill dateRequired_Skills- Required skills for the roleJob_Description- Full job descriptionRemote_Job- Whether the position is remotePublish- Whether the job is published
City- Job location cityState- State or provinceCountry- CountryZip_Code- Postal code
Client_Name- Associated clientContact_Name- Associated contactAccount_Manager- Account manager for the position
Created_Time- Record creation timestampModified_Time- Last modification timestampCreated_By- User who created the recordModified_By- User who last modified the recordOwner- Record owner
Contacts
Contacts
Contact persons at client companies involved in the recruitment process.Key Fields:
id- Unique identifier for the contactFirst_Name- Contact’s first nameLast_Name- Contact’s last nameEmail- Email addressMobile- Mobile phone numberPhone- Phone numberTitle- Job titleDepartment- DepartmentFax- Fax number
Mailing_City- CityMailing_State- State or provinceMailing_Country- CountryMailing_Zip- Postal codeMailing_Street- Street address
Client_Name- Associated client company
Is_Locked- Whether the record is lockedCreated_Time- Record creation timestampModified_Time- Last modification timestampCreated_By- User who created the recordModified_By- User who last modified the recordOwner- Record owner
Interviews
Interviews
Scheduled and completed interviews linking candidates to job openings.Key Fields:
id- Unique identifier for the interviewInterview_Name- Name of the interviewInterview_Status- Status of the interview (e.g., Scheduled, Completed)From- Interview start timeTo- Interview end timeLocation- Interview locationSchedule_Comments- Comments about the schedule
Interview_Owner- Owner of the interviewCandidate_Name- Candidate being interviewedJob_Opening_Name- Associated job openingInterviewer- List of interviewers
Is_Locked- Whether the record is lockedCreated_Time- Record creation timestampModified_Time- Last modification timestampCreated_By- User who created the recordModified_By- User who last modified the recordOwner- Record owner
Clients
Clients
Client companies that have open positions or recruitment agreements.Key Fields:
id- Unique identifier for the clientClient_Name- Name of the client companyWebsite- Client websitePhone- Phone numberFax- Fax numberIndustry- Industry sectorAbout_Client- Description of the client
Billing_City- CityBilling_State- State or provinceBilling_Country- CountryBilling_Code- Postal codeBilling_Street- Street address
Is_Locked- Whether the record is lockedCreated_Time- Record creation timestampModified_Time- Last modification timestampCreated_By- User who created the recordModified_By- User who last modified the recordOwner- Record owner
Notes
Notes
Notes attached to various records in Zoho Recruit, such as candidates, job openings, or clients.Key Fields:
id- Unique identifier for the noteNote_Title- Title of the noteNote_Content- Body content of the noteParent_Id- The record this note is attached tose_module- The module of the parent record (e.g., Candidates, Job_Openings)
Created_Time- Record creation timestampModified_Time- Last modification timestampCreated_By- User who created the recordModified_By- User who last modified the recordOwner- Record owner