JobMinglr for Zoho Recruit

Admin guide

For Zoho Recruit administrators. Installation, the connection, the three settings, the two automations, and the complete list of what the extension can touch. Budget about ten minutes.

Last updated 22 August 2026

Before you start

Administrator access to a Zoho Recruit Enterprise account. Zoho gates Marketplace extensions to paid editions, so this extension cannot be installed on Free edition — Free-edition accounts use the JobMinglr API integration instead, which needs nothing installed in Recruit.
A JobMinglr recruiter account with your company profile set up. Create one at jobminglr.com/register if you do not have one.
Your JobMinglr bridge token and your Recruit organisation id — step 3 below says where each comes from.

1. Install the extension

1
Install from the Zoho Marketplace
In Zoho Recruit go to Setup → Marketplace → All, find JobMinglr, and choose Install. Accept the terms and pick whether the extension is available to all users or to selected profiles.
2
Confirm the panel appears
After install, the JobMinglr settings panel is available from the Marketplace entry. It is the panel you will use in step 4 to verify the connection.

2. Create the Recruit connection

The extension creates Candidates through a Zoho connection, which is what supplies the access token — so this has to exist before the sync can run.

1
Open Connections
Setup → Developer Space → Connections → Create Connection → Zoho Recruit.
2
Name it exactly jobminglr_recruit
The connection link name must be jobminglr_recruit. The extension looks it up by that name — a different name means the sync cannot authenticate.
3
Scope and credentials
Select the scope ZohoRecruit.modules.ALL, set Use Credentials Of Login User to Yes, then Create And Connect and authorise.

Use a service account, not a personal one

The connection carries the authorising user's permissions. If that person leaves and their user is deactivated, the sync stops. An administrator service account avoids that.

3. Configure the three settings

Open the extension settings from the Marketplace entry and fill in three values:

Setting	Label in Recruit	What to enter
`bridge_base_url`	JobMinglr gateway base URL	Leave as `https://zoho.jobminglr.com` unless JobMinglr support gives you a different host.
`bridge_token`	JobMinglr bridge token	Your company token, generated for you in JobMinglr under Company Profile → ATS Integrations. Treat it as a password.
`org_id`	This Recruit org id	Your Zoho Recruit organisation id, from Setup → Company Details in Recruit. It tells JobMinglr which account to deliver to.

The bridge token is a credential

It authorises delivery to your JobMinglr account. Do not share it outside your Recruit administrators, and ask JobMinglr support to rotate it if it is ever exposed. Rotating invalidates the old value immediately — paste the new one into this setting.

4. Verify the connection

In the JobMinglr panel, choose Test connection. A success means Recruit can reach the JobMinglr gateway with your settings. Preview applicants then shows the candidates currently waiting to be delivered, without creating anything yet — a safe way to confirm the pairing before you switch the automations on.

5. Switch on the two automations

1
Send openings out — a workflow rule on Job Openings
Setup → Automation → Workflow Rules → Create Rule on the Job Openings module. Trigger it on Create and on Edit of Job Opening Status, then add the instant action Function → jm_pushJob, passing the record id as the jobId argument.
2
Pull candidates in — a scheduled function
Setup → Developer Space → Functions → jm_syncApplicants → Schedule. Every 15 minutes is the recommended interval. Each run pulls only applicants added since the previous run.
3
Backfill your existing openings (optional)
The workflow rule only fires on new saves. To register roles that already exist, edit each opening status — or ask JobMinglr support to backfill them for you.

What the extension can access

Area	Access	Why
Job Openings	Read	To know which roles to match candidates against, and to stop matching when a role closes.
Candidates	Create	To deliver a candidate who applied to one of your roles.
Candidate to Job Opening association	Create	To link each delivered candidate to the opening they applied to.
Extension storage	Read and write	Holds a single cursor so each sync run only pulls new applicants.
Everything else	No access	No other module, no users, no billing, no other Zoho service.

Candidate data delivered into your account is processed under the JobMinglr privacy policy; the security overview covers how it is stored and transmitted.

Turning it off, and uninstalling

Pause deliveries: disable the schedule on jm_syncApplicants. Nothing new is created; openings keep syncing.
Stop sending openings: deactivate the Job Openings workflow rule.
Full uninstall: Setup → Marketplace → JobMinglr → Uninstall, then delete the jobminglr_recruit connection so no token remains. Candidates already delivered stay in your account.

If a step does not behave as written

The help document lists the errors these steps can produce and the fix for each, plus where Zoho keeps the function logs. Anything it does not cover goes to support@jobminglr.com.