Setting up the HireHunch integration

Send skill assessments, run technical video interviews, and hand off first-round tech interviews to HireHunch's expert panel, all triggered from your JusRecruit pipeline, with results posted straight back to the candidate profile.

Roles requiredAdmin on JusRecruit + Admin on HireHunch
PlanATS Integration enabled on HireHunch
Setup time~10 minutes
JusRecruitcandidate moved a stagewebhookStage reads two things1. Stage type(Assessment / Interview)2. Integration tag on stageHireHunchHunchAssessHunchVueHunchServe
HireHunch decides what to run from the integration tag on the stage, not the stage's name. Name your stages anything you like.

Overview

The HireHunch integration lets teams using JusRecruit send skill assessments (HunchAssess), conduct technical interviews on HireHunch's own video platform (HunchVue), and hand the first technical round to HireHunch's expert interviewers (HunchServe), without leaving the JusRecruit pipeline. Assessment results, interview links, and interviewer feedback are all posted back as notes on the JusRecruit candidate profile.

RolesAdmin on JusRecruit (to set up) and Admin on HireHunch.
PermissionsManage API keys, manage webhooks, manage pipeline stages and integration tags, manage jobs and candidates.
PlansAvailable on JusRecruit accounts with the ATS Integration capability enabled on HireHunch.
Step A

Connect your JusRecruit account

  1. You'll need Admin access on both JusRecruit and HireHunch to set this up.
  2. In JusRecruit, go to Settings → Recruitment → API Keys and click Add API Key. Name the key, enable the permissions listed below, and save. Copy the key that's shown. It appears only once.

Permissions the key must have

HireHunch uses each of these during the integration. The connection won't work if any are missing.

PermissionWhy HireHunch needs it
Fetch company detailsLinks your JusRecruit company to HireHunch when you save the key.
Fetch CandidatesReads the candidate being moved, and the interview slot for HunchVue.
Fetch WorkflowReads the stage and its integration tag to decide which product to run.
Fetch JobsReads the job and its tags, such as the assessment to send.
Fetch user detailsIdentifies the recruiter who moved the candidate.
Send NotesPosts results, interview links, and status back to the candidate profile.
⚠If a permission is missing, JusRecruit rejects the request and HireHunch emails your account admins with the name of the permission to enable.

Minimum permissions per product

Enabling all six is simplest. If you only use certain products, this is the minimum each one needs. Fetch company details is always required to connect.

PermissionHunchAssessHunchVueHunchServe
Fetch company details✓✓✓
Fetch Candidates✓✓✓
Fetch Workflow✓✓✓
Send Notes✓✓✓
Fetch user details–✓✓
Fetch Jobs––✓
  1. In HireHunch, open the profile menu → Integrations, find the JusRecruit card, and click Configure.
  2. On the JusRecruit Integration page (Step 1), paste the API key and click Save. HireHunch validates the key and links your JusRecruit company.
Step B

Configure webhooks in JusRecruit

Once your account is connected, the HireHunch integration page shows four webhook URLs. In JusRecruit, go to Settings → Webhooks. For each event type below, click Add Webhook, paste the matching URL, click Generate to create a secret, and save.

Assessment Stage Movedhttps://<hirehunch-host>/jusRecruit/assessmentStageChange
Interview Stage Movedhttps://<hirehunch-host>/jusRecruit/interviewStageChange
Assessment Stage Updatedhttps://<hirehunch-host>/jusRecruit/assessmentStageUpdated
Interview Stage Updatedhttps://<hirehunch-host>/jusRecruit/interviewStageUpdated
ⓘJusRecruit requires a secret for every webhook. Always click Generate before saving. Use the exact URL from the HireHunch page, which points to the HireHunch API host. Once all four are saved, the connection is complete.

How HireHunch products are triggered

Each HireHunch product runs when a candidate is moved into a pipeline stage set up for it. Two things on the stage decide what happens:

  • The stage type (Assessment or Interview), which controls which webhook JusRecruit sends to HireHunch.
  • An integration tag on the stage (HunchAssess, HunchVue, or HunchServe), which tells HireHunch which product to run.

The tag is what matters: HireHunch decides what to do from it, not from the stage's name, so stages can be called anything you like. Add a tag to a stage from the pipeline setup using the Add Integration Tag field.

HunchAssess · skill assessments
Assessment-type stage · tag HunchAssess

1. Set up the stage

  1. In JusRecruit, open your hiring pipeline and add or select an Assessment-type stage.
  2. Open the stage in the pipeline setup and, in Add Integration Tag, select HunchAssess.

Any candidate moved into this stage is treated as a HunchAssess request. The stage must be an Assessment stage carrying the HunchAssess tag.

2. Add the assessment to the job

  1. In HireHunch, open the Assessment (HunchAssess) tab and copy the assessment ID by hovering over the relevant assessment.
  2. In JusRecruit, open the job and add the tag HunchAssess:<Assessment_ID> to the job's tags field, e.g. HunchAssess:2w1rub7r.

3. Invite candidates

  1. Assign the candidate to a job that carries the HunchAssess:<Assessment_ID> tag.
  2. Move the candidate into the HunchAssess-tagged Assessment stage.
  3. HireHunch registers the candidate and automatically sends the assessment-invitation email.
  4. A note is added to the candidate profile confirming the invite. Once the candidate completes it, results are posted back as a note.
HunchVue · video interviews
Interview-type stage · tag HunchVue

1. Set up the stage

  1. In JusRecruit, open your hiring pipeline and add or select an Interview-type stage.
  2. Open the stage in the pipeline setup and, in Add Integration Tag, select HunchVue.

2. Schedule an interview

  1. Move the candidate into the HunchVue-tagged Interview stage.
  2. HireHunch creates a HunchVue meeting and posts a note to the candidate profile with the interview link and joining instructions.
ⓘOptional: if the candidate has a scheduled interview slot in JusRecruit, HireHunch uses that interviewer and time; otherwise it defaults the time and uses the recruiter who moved the candidate.

Once the interview is conducted, the interviewer's feedback and the playback link are posted back as a note on the candidate profile.

HunchServe · interview as a service
Interview-type stage · tag HunchServe

HireHunch's expert interviewers conduct the initial technical round on your behalf. The candidate is added to a HireHunch job and an interview is created.

1. Set up the stage

  1. In JusRecruit, open your hiring pipeline and add or select an Interview-type stage.
  2. Open the stage in the pipeline setup and, in Add Integration Tag, select HunchServe.

2. Prepare the HireHunch job post

HunchServe runs the interview against a HireHunch job post, so set this up first:

  1. In HireHunch, create a new job post, or select an existing one that fits the role.
  2. Make sure the job post is approved.
  3. Configure at least one feedback form for that job post and get it approved.
⚠The interview can only be scheduled from JusRecruit once the job post is approved and has an approved feedback form. Note the HireHunch job post ID for the next step.

3. Map the HireHunch job

In JusRecruit, add the tag HunchServe:<HireHunch_Job_ID> to the job, using the ID of the approved HireHunch job post. This maps the candidate to that job.

4. Automatic checks

When a candidate is moved into the stage, HireHunch validates the following. If any check fails, HireHunch posts an explanatory note back to the candidate profile instead of scheduling:

  • The mapped HireHunch job post is approved and has an approved feedback form.
  • The company has sufficient HunchServe (IAAS) credits.
  • The candidate has a resume and an email address.

5. Request an interview

  1. Move the candidate into the HunchServe-tagged Interview stage.
  2. HireHunch creates the candidate and interview, requests interviewer scheduling, and posts an "Interview requested" note with a link to the interview on the candidate profile.
⚠If the candidate already exists under a different HireHunch job posting, HireHunch posts a note asking you to contact the HireHunch team to move them to the correct posting.

Disabling the integration

  1. In JusRecruit, go to Settings → Webhooks and delete (or deactivate) the HireHunch webhooks.
  2. In JusRecruit, go to Settings → Recruitment → API Keys and delete the API key used for HireHunch.
  3. The JusRecruit card in HireHunch will show Reconfigure. To reconnect later, generate a new API key and repeat the setup steps.
Was this article helpful?
Still stuck? Our team can help you get connected.