1. Harver Knowledge Base
  2. Integrations
  3. ATS Setup Guides

iCIMs

Follow

The setup guide provides step by step guidelines and instructions on connecting the iCIMs account with the Harver that will allows you to invite candidates to an assessment and see the candidate results in the iCIMs.

Before setting up the integrations, check the Integration Guidelines and Integration FAQs to make sure you have all necessary information and configurations ready in Harver Platform.

In this Guide

  1. Instructions before enabling Integrations
  2. Harver Integration Configuration Steps
  3. iCIMs Integration Configuration Steps
  4. Adding Harver in workflow to invite candidate
  5. Inviting candidate(s) to take an assessment
  6. Candidate progress & results
  7. Validating Integration Setup
  8. Additional Questions/Support

Instructions before enabling Integrations

Before enabling integrations, make sure you have;

  1. The requisitions in ATS and vacancies in Harver are configured.

  2. From iCIMS to share with Harver; these will need to be entered into Harver:

    1. Base url: This is endpoint for connecting to iCIMS
    2. API Credentials
    3. Customer ID: The client’s unique identifier in iCIMS (numeric value)

  3. From Harver to share with iCIMS; these will need to be provided to iCIMS IS to enter into iCIMS:

    1. Harver Vacancy: This is the assessment package that needs to be loaded into the Assessment Type and Assessment Name fields in iCIMS if using a single assessment.
      Must be loaded into iCIMS in this format:
      Harver Vacancy Name – Harver Vacancy ID (needs the word Harver in front)
    2. Harver API Endpoint: This is the endpoint for connecting to Harver (check with Harver to confirm which instance your Harver account is in - the endpoint for US instance is different) 
      https://integrations.harver.com/prod/orchestrator/v1/flows/startAssessment/icimsmarketplace
    3. Harver API Credentials
    4. List of IP Addresses to Whitelist: 80.113.26.114, 35.158.208.210, 54.229.248.124, 52.51.44.10, 124.43.10.11, 52.29.23.29, 34.241.38.163, 34.247.200.75, 54.171.191.142, 52.48.58.158, 3.19.247.132, 18.217.100.151, 3.139.115.195
  4. Candidate Return URL: For better candidate experience, in Harver Platform add the iCIMs applicant return URL in Harver End Page configuration provided by the iCIMs so candidate can be redirected to iCIMs to continue the application. See End Page for more details.

Harver Integration Configuration Steps

Login to Harver platform to perform below steps. You must be a Harver Admin to be able to complete all these step.

  1. In Harver platform, go to Integration Menu tab and clicks Add new integrations. Select the iCIMs Marketplace from drop down and Clicks Add Integrations.Add Integration_Dropdown 7.png
  2. This will start configuring the integration and progress will be shown. Once completed, click on Continue to Overview.Setup Progress (5).png

  3. In the General section, select the Integration Pattern(s) that you intend to use. The options available include:

    1. ATS First Inline (seamless experience - application complete)

    2. ATS First Ad-Hoc (interactive - workflow status change)
      General Section_Select Pattern (3).png

  4. Next, go to the Credentials section and Click Harver to ATS tab. Here, you can configure the credentials provided by iCIMS.

    Note: iCIMS supports two methods of Authentication - oAuth2 and Basic Authentication.

    Harver has the oAuth2 Authentication method selected by default. To continue with oAuth2, select the “Edit ATS credentials” button and provide the following details, provided by client or iCIMS:

    1. Client ID

    2. Client Secret

    3. Customer IDHarver to ATS (3).png

    To switch to Basic Authentication, click the “Edit ATS credentials” button and select the “Authentication Method” modal to switch from oAuth2 to “Basic authentication.”

    Change Auth Method.png

    After switching to “Basic authentication,” enter the following details provided by iCIMS:

    1. Username
    2. Password
    3. Customer ID

  5. Go to the ATS to Harver tab where you will see the Harver API credentials (Username and Password) that will be used for connecting to Harver. Copy these Harver API credentials, the Harver API endpoint and IP addresses for whitelisting mentioned above and share with iCIMS:

    ATS to Harver.png

  6. Next go to the ATS to Harver section and configure the following:

    1. Multi-Phased Assessments Configuration: By activating this feature, this will allow recruiters to select more than one Harver assessment package (vacancy) at different points in their recruiting process when inviting candidates. In iCIMS, the recruiter will be prompted with a “Confirm or Modify” package button. The assessment packages must be selected in Harver.
      If you are using a single assessment only on a job, then you should not enable this feature; assessment package will be selected in iCIMS.Edit ATS to Harver.pngEdit Mode_ATS to Harver_Multi_Phase.png

    2. Assessment Status: Enabling this feature will let iCIMS know the candidate application is in progress; in iCIMS, users will see the In-Progress status.Edit Mode_ATS to Harver_Assessment Status.png

  7. Go to the Harver to ATS section and click the Assessments tab:

    1. Assessments Status: These values will be defaulted. This is used for letting iCIMS know the candidate application is completed; in iCIMS, users will see the Completed status.Harver to ATS Assessments.png

    2. Click the Reports tab. Select only one report type to be sent to iCIMS. Reports (1).png

      The ATS field ID will be defaultedEdit Reports.png

  8. Once all configurations are completed, go back to the General section. Enable the integration:
    General Section_Activate (4).png

If enabling integration fails, error will be shown. Please fix particular issue to enable the integrations successfully.

Note: that incase you want to discontinue with ATS or disable integration due to some reason, same configuration toggle is used to disable the integration with ATS.

iCIMs Integration Configuration Steps

To configure the Harver credentials, endpoints, whitelisting IPs and enabling the Harver integration in iCIMs ATS, contact iCIMs support team on steps.

Adding Harver in workflow to invite candidate

To invite a candidate to Harver, the first step is to add the Harver assessment on the job (only if you are using a single assessment).

  1. Go to the job in iCIMS and select the Harver assessment package in the Assessment Type field.

    Note: iCIMS typically helps load assessment packages so they appear in this field. image-20240313-132634.png

  2. When candidate applies for the job,

    1. If its application complete (inline) flow, when the candidate fills the application in iCIMS until the last step, there will be a link displayed for the candidate to proceed to the Harver platform to do assessment.

    2. If its workflow status change (adhoc) flow, recruiters can invite candidate(s) to take the assessment by selecting the candidate (See steps below).

      Please note: When you create a test applicant, create a Candidate not a Person.

image-20250709-105618.png

Inviting candidate(s) to take an assessment

Follow the steps below to invite candidates to take assessments.

  1. Go to Candidate Page and click on “Submit to Job”

    image-20250709-121116.png

  2. Then Submit to a Workflow - Double Click to add to the Selected area and then “Submit“image-20250709-121235.png
  3. Next, go back to the job and under the People tab, you will see the candidate is under the New Submissions panel; select the checkbox next to the candidate.image-20250709-121433.png
  4. In the bottom, click on “Advance“ and then “Send to Harver“image-20250709-121513.png

Note: Harver will receive a request and will respond with an Assessment link email to the candidate

A Summary page will show “Invitation is sent to Candidate“

image-20250709-130402.png

Please note the email invitation from Harver is configurable. Below is an example of the email to the candidate:

image-20250709-110042.png

Candidate progress & results

When the candidate is moved to the Send to Harver workflow status, the candidate will be redirected to Harver to take the assessment.

You will be able to see the assessment status In Progress in iCIMS.

image-20250709-103600.png

After the assessment is completed by the candidate, you will see the assessment status Complete and results are in iCIMS; this is found under the Assessments section> Screen tab.image-20250709-130748.png

Multi-Phase Support

Recruiters can invite candidates to take an additional assessment by advancing the candidate to the Send to Harver workflow status. Assessment packages are selected in Harver rather than in iCIMS. Recruiters must click the Confirm or Modify Package button and be redirected to Harver so they can select the assessment(s) they want the candidate to take.

image-20240313-140327.png

Validating Integration Setup

Please take a moment to ensure your Integration setup was configured successfully. We recommend you complete the following steps:

  1. Create a test Job Requisition for a position that will leverage an assessment.
  2. Add the appropriate Harver Job Code/assessment to the test requisition.
  3. Complete a candidate application, including the assessment.
    1. Confirm the candidate experience.
  4. Review results on hiring dashboard in your ATS and confirm you see the following:
    1. Assessment Recommendation.
    2. Link or access to the full report details.

Additional Questions/Support

For any additional queries, please contact support team at support@Harver.com

Was this article helpful?
0 out of 0 found this helpful