> For the complete documentation index, see [llms.txt](https://docs.skolar.li/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skolar.li/integrations/zoho-recruit.md).

# Zoho Recruit

## Zoho Recruit

Send Skolarli assessments to candidates from inside Zoho Recruit, and see their status, scores and report on the candidate record without leaving Zoho.

**Time to set up:** about 10 minutes.

### Overview

The **Skolarli Assessments** extension adds a **Send Skolarli assessment** button to candidates in Zoho Recruit:

1. **Send:** a recruiter opens a candidate who is associated with a job opening and presses the button. Skolarli emails the candidate the job's assessments (coding tests, skills tests, AI interviews or proctored tests).
2. **Track:** the candidate's Skolarli fields in Zoho update by themselves, about every 15 minutes: status, a line per test with the score, trust score and integrity flags, and a link to the full report.
3. **Decide:** open the report in Skolarli from the candidate, or from the button's window.

Each Zoho Recruit job opening gets a matching job in Skolarli. Its job code starts with **ZR-**.

### Before you start

| Where        | What you need                                                                                                                    |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| Zoho Recruit | An **administrator**, who installs the extension for the whole account                                                           |
| Zoho Recruit | A plan that allows Marketplace extensions                                                                                        |
| Skolarli     | An **admin** account                                                                                                             |
| Skolarli     | The **Skolarli Decision Engine** app installed, active, and with its API key generated (**Apps** ⇒ **Skolarli Decision Engine**) |

The extension works with Zoho Recruit accounts in Zoho's regions (US, India, Australia, Japan, and Canada) where it's listed in the Marketplace.

### Step 1: Get your Skolarli API key

1. In Skolarli, click **Apps** at the top of the side menu.
2. Find the **Zoho Recruit** card and click **Install**.
3. Click **Generate API key** and copy the key. It's shown only once.
4. Note your **Skolarli workspace name** shown in the same window (for example, `acme`).

> **Keep the key private.** Anyone who has it can send assessments from your workspace. Skolarli keeps only a fingerprint of it and can't show it again; if you lose it, click **Roll API key** and use the new one.

### Step 2: Install the extension in Zoho Recruit

1. In Zoho Recruit, open **Setup** ⇒ **Marketplace**, find **Skolarli Assessments** and click **Install**.
2. Choose who can use it (usually everyone who sends assessments).
3. When asked to connect **Skolarli**, paste the API key from Step 1.
4. When asked to allow access to **Zoho Recruit**, click **Accept**. The extension reads candidates and job openings, and writes only its own Skolarli fields.
5. Enter your **Skolarli workspace name** from Step 1.

The extension adds a **Skolarli** section to candidates with these fields, and the **Send Skolarli assessment** button.

### Step 3: Add assessments to each job

Assessments are attached to jobs in Skolarli, so everyone sending for a job sends the same tests.

1. In Zoho Recruit, open a candidate associated with the job and click **Send Skolarli assessment**.
2. The first time, the window says the job has no assessments yet, and the job now exists in Skolarli (code **ZR-…**). Click **Open job in Skolarli**.
3. Add the assessments, and rounds if you use them, to the job in Skolarli.
4. Back in the window, click **Check again**. The assessments appear, ready to send.

From then on, every candidate on that job is sent the same assessments.

### Sending an assessment

1. Open the candidate and click **Send Skolarli assessment**.
2. If the candidate is on more than one job, pick the job.
3. Click **Send** (or **Send round 1** on a job with rounds). The window confirms who it was sent to.
4. Click **Refresh page** to see the Skolarli fields filled in.

**Rounds:** only round 1 goes from Zoho. Later rounds are sent from Skolarli as candidates pass, and they appear on the candidate in Zoho by themselves.

**Lost the email?** Open the window again and click **Resend email**. It re-sends only tests the candidate hasn't started.

### Results in Zoho Recruit

| Field                                      | Shows                                                                                                            |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| Skolarli Status                            | Invited, Started, Submitted (waiting for marks), Next Round Pending, Completed, See Report, Abandoned or Expired |
| Skolarli Results                           | One line per test, for example `Round 1 of 2: Screening test, Completed, 34/40 (85%), trust 92, 1 flag`          |
| Skolarli Report                            | A link to the candidate's full report in Skolarli (sign in to Skolarli to open it)                               |
| Skolarli Assessments                       | The tests sent, used by the extension                                                                            |
| Skolarli Candidate Code, Skolarli Job Code | The candidate and job in Skolarli                                                                                |
| Skolarli Last Sent                         | When the assessments were last sent                                                                              |
| Skolarli Last Checked                      | When the results last changed                                                                                    |

The fields update about every 15 minutes while a candidate's results change. Skolarli stops checking when every round is finished, or 30 days after the last send. The window always shows the latest results from Skolarli, and once there's a result, **Open candidate in Skolarli** opens the candidate's report.

### Messages you may see

| Message                                          | What to do                                                                                                                |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Skolarli isn't set up yet                        | An administrator enters the Skolarli workspace name in the extension's settings                                           |
| Skolarli didn't accept the connection            | An administrator checks the API key in the extension's Skolarli connection (or rolls a new key in Skolarli and pastes it) |
| Add this candidate to a job opening first        | Associate the candidate with a job opening in Zoho Recruit                                                                |
| This job has no assessments yet                  | Open the job in Skolarli, add assessments, then **Check again**                                                           |
| They've already been sent this                   | Their progress is shown in the window; use **Resend email** if they lost it                                               |
| The first round's test has ended                 | Extend the test in Skolarli, then send again                                                                              |
| This email belongs to another Skolarli candidate | Check the candidate in Skolarli, then try again                                                                           |
| Skolarli couldn't do that right now              | Try again in a few minutes                                                                                                |

### Your data

* **Sent to Skolarli:** the candidate's name, email and phone, and the job opening's title, description and client or department. Nothing else from Zoho Recruit.
* **Written to Zoho Recruit:** only the Skolarli fields listed above.
* **Keys:** your Skolarli API key stays in Zoho's connection. To write results back, Skolarli keeps the extension's Zoho key encrypted, and uses it only to update the Skolarli fields.

### Removing the extension

Uninstall **Skolarli Assessments** in Zoho Recruit (**Setup** ⇒ **Marketplace** ⇒ **Installed**), and uninstall or deactivate the Zoho Recruit app in Skolarli (gear menu on the app card). Results already in Skolarli stay there.
