Utkrushta × Zoho Recruit · Integration

What the recruiter actually sees, in all three onboarding options

Three ways to connect Zoho Recruit to Utkrushta — from a 15-minute manual pilot to a two-click marketplace install — shown screen by screen, with everything we've verified in live testing.

✓ Auto-trigger verified live ✓ Read + write proven on a real account Status: pre-build July 2026

First, the part that never changes

The everyday experience — identical in all three options

Once connected, the recruiter's only recurring action is something they already do every day: moving a candidate along their pipeline. Everything else — sending the test, scoring it, filing the result — happens on its own.

Recruiter · daily work
recruit.zoho.in/candidates
Zoho Recruit

Priya Sharma

Candidate · Frontend Developer

NewIn Review ←OfferedHired

Recruiter drags the stage to In Review — that's the whole action.

Zoho pings us instantly
Utkrushta · automatic
candidate inbox
Utkrushta

✉️ Assessment invite sent

to priya@example.com

Your Frontend Developer assessment Hi Priya — you've been invited to a skill assessment. Start your test →

Test session created & emailed — no recruiter input.

candidate takes it, we score it
Back in Zoho · automatic
recruit.zoho.in/candidates
Zoho Recruit

Priya Sharma

Candidate · Frontend Developer

Utkrusht Score
82
Utkrusht Assessment — Score 82/100 Overall: Strong. Full report ↗

The score lands as a real, sortable field plus a note with the full report link — on the exact candidate page the recruiter already lives in. They never open a second tool.

The one-time setup — where the options differ

Three ways to onboard, screen by screen

The options change only who does the one-time setup. Each screen below is what the recruiter sees, in order, labeled by who's doing the work.

Automaticwe handle it — recruiter just clicks Guidedrecruiter does it with our step-by-step help
OPTION 1

Manual pilot

one-time setup ~15 min

Buildable this week. We provide the Connect button and a written guide; the recruiter creates three things inside Zoho's settings by hand.

Step 1 · 1 click
app.utkrushta.co.in/settings
Utkrushta · Integrations

Connect your ATS

Sync candidates & push scores automatically.

Connect Zoho Recruit

One button — all the token & security setup happens behind it.

Step 2 · approve once
accounts.zoho.in/oauth
Zoho Accounts

Utkrusht wants to access your Zoho Recruit

Accept Reject
now the manual part
Step 3 · make the field
Setup › Modules and Fields
Zoho Setup

Candidates layout

Drag a Number field into the layout:

⠿  Utkrusht Score  Number

5 clicks, once. Our guide shows exactly where.

Step 4 · make the webhook
Setup › Automation › Webhooks
Zoho Setup

New Webhook

Name
Utkrusht Trigger
URL to notify — paste from us
https://api.utkrushta.co.in/ats/zoho/…
Method
POST · Candidates
Step 5 · make the rule
Setup › Workflow Rules
Zoho Setup

New Workflow Rule

WhenCandidate Status changes
Then→ Utkrusht Trigger

Save — setup done. From here it's the everyday loop above.

OPTION 2

Guided wizard

one-time setup ~5 min

Same three Zoho-side steps — but a wizard inside Utkrushta walks the recruiter through each one with copy-paste values and live checkmarks as we detect each piece.

Step 1 · 1 click
app.utkrushta.co.in/settings
Utkrushta · Integrations

Connect your ATS

Same one-click connect as Option 1.

Connect Zoho Recruit
Step 2 · follow the wizard
app.utkrushta.co.in/setup/zoho
Utkrushta · Zoho setup — 2 of 3

Create the webhook in Zoho

Copy this URL  📋
https://api.utkrushta.co.in/ats/zoho/…
Score field detecteddone
Webhookwaiting…
Workflow rulewaiting…
we verify each piece live
Step 3 · all green
app.utkrushta.co.in/setup/zoho
Utkrushta · Zoho setup — done

You're connected 🎉

Account connecteddone
Score fielddone
Webhookdone
Workflow ruledone

Wizard confirms each item as it detects it — nothing silently misconfigured.

OPTION 3 · THE GOAL

Marketplace install

one-time setup 2 clicks

We publish “Utkrusht” on the Zoho Marketplace. The extension provisions the field, webhook, and rule by itself on install — the only path to a true zero-setup experience.

Step 1 · install
marketplace.zoho.com
Zoho Marketplace

🟩 Utkrusht — Skill Assessments

Auto-send assessments on stage change; scores land on the candidate. ★★★★★

Install
Step 2 · authorize
accounts.zoho.in/oauth
Zoho Accounts

Authorize Utkrusht

Authorize
extension does the rest
Done · provisioned itself
recruit.zoho.in
Zoho Recruit · Utkrusht installed

Utkrusht is ready ✓

“Utkrusht Score” fieldcreated
Webhookcreated
Workflow rulecreated

Recruiter never opens Setup. Two clicks total.

Side by side

Who does each setup step

Setup stepOption 1 · ManualOption 2 · WizardOption 3 · Marketplace
Connect the account1 click1 click1 click
Create the score fieldRecruiter, manualRecruiter, guidedAutomatic
Create the webhookRecruiter, manualRecruiter, guidedAutomatic
Create the workflow ruleRecruiter, manualRecruiter, guidedAutomatic
Send tests, forever afterJust move stagesJust move stagesJust move stages

The bottom row never changes. Only the one-time rows move from manual toward automatic as we invest more in building.

Why can't we automate the middle rows without the Marketplace?

The account connection fully disappears behind one button — we handle all tokens, security, and region detection. But the score field, webhook, and workflow rule cannot be created through Zoho's normal API — we proved it in testing (a hard 400 error). The only mechanism that can provision them automatically is a published Marketplace extension that declares them on install. That single fact is what separates Option 3 from the other two.

Testing phase

What we've already proven — on a real Zoho account

Before writing any production code, we ran the entire flow live against a real Zoho Recruit account. Every piece works; this is no longer theory.

Four things the official docs got wrong

Each of these would have been a shipped bug if we'd built from documentation alone. All are now pinned down.

The API address the docs point to fails

Zoho's login response hands back one address, but Recruit's data actually lives at recruit.zoho.in. The “official” one returns 404.

Documented permission names are rejected

The fine-grained permission strings in the guide are refused by Zoho's own console. One broader permission (modules.ALL) is what actually works.

Notes save through a different door

Writing a note where you'd expect fails with a method error. Notes go through a separate endpoint with the candidate's id attached.

Custom fields can't be created by software

Creating the score field via API returns a hard error — it must be made in Zoho's settings, or bundled into a Marketplace extension. This shapes the three options above.

Two things worth knowing about the auto-trigger

It works — verified live

Changing a candidate's stage in Zoho instantly sent a request to our test endpoint, straight from recruit.zoho.in. The make-or-break piece is solid.

It needs a paid Zoho plan

Webhooks exist on Zoho's Professional & Enterprise plans only — not the free tier. Real customers on paid plans are unaffected.

Still to verify:

We proved the score field can't be auto-created via API. We strongly suspect the webhook and workflow rule are the same — which would confirm the Marketplace extension is truly the only route to Option 3. One quick follow-up test will settle how much Option 2's wizard could automate.

Recommendation

Where to start

Ship Option 1 for the first design-partner customer — buildable now, API fully proven. Add Option 2's wizard as customers grow. Invest in the Option 3 extension when we commit to polished self-serve — it's the only path to the true two-click install.