I use ARKiiV (CiiVSOFT). What does the integration look like? How do I enable it?

 

ARKiiV INTEGRATION SETUP AND USAGE INSTRUCTIONS 

SECTION 1 – CREATE API KEYS

IN ORDER TO CREATE API KEYS USERS NEED TO HAVE DEVELOPER PERMISSIONS ENABLED ON THEIR USER ACCOUNT. USERS WHO DO NOT HAVE DEVELOPER PERMISSIONS ENABLED NEED TO CONTACT THEIR GREENHOUSE ‘SUPER USER(S)’ WHO WILL BE ABLE TO ENABLE DEVELOPER PERMISSIONS ON THEIR USER ACCOUNT OR OTHERWISE GENERATE THE API KEYS DIRECTLY

CiiVSOFT requires the Greenhouse user to create two API keys. These are:

  • Harvest API Key
  • Job Board API Key

To create a Harvest API key: 

  • The Greenhouse user will go to their Configure tab on the dashboard

ak1.png 

  • Click Dev Center from the menu in the left hand column

 ak2.png

  • Click API Credential Management from the menu in the middle column 

ak3.png 

  • Click Create New API Key

ak4.png 

  • Enter CiiVSOFT1 in the ‘Description’ field then select Harvest from the dropdown list in the ‘Type’ field

ak5.png  

  • Click Create

 ak6.png

  • ARKiiV only requires access to 5 endpoints in the Harvest API. These are:
  • Candidates - GET – List Candidates
  • Candidates - GET – Retrieve Candidates
  • Job Posts – GET – List Job Posts
  • Offices – GET – List Offices
  • Users – GET – List Users

Select these endpoints within the parent / child dropdown selection of permissions like this

 ak7.png 

  • Click ‘Update’ at the bottom of the list to complete the creation of the API key
  • The Harvest API key is now created and is visible in the list

ak8.png 

  • Click Copy to make a copy of the Harvest API key ID. Please paste the ID into the corresponding field of the ARKiiV PRE-INTEGRATION QUESTIONNAIRE supplied

 ak9.png 

YOU NOW NEED TO CREATE A JOB BOARD API KEY

To create a Job Board API key: 

  • Click Create New API Key

ak10.png  

  • Enter CiiVSOFT2 in the ‘Description’ field then select Job Board from the dropdown list in the ‘Type’ field 

 ak11.png

  • Click Create

ak12.png  

  • The Job Board API Key is now created and visible in the list

 ak13.png

  • Click Copy to make a copy of the Job Board API key ID. Please paste the ID into the corresponding field of the ARKiiV PRE-INTEGRATION QUESTIONNAIRE supplied

 ak14.png

SECTION 2 – JOB BOARD / CAREERS PAGE URL AND JOB BOARD TOKEN

CiiVSOFT requires the Job Board URL for the Greenhouse hosted company careers page / job board and also the corresponding Job Board URL Token

  • The Greenhouse user will go to the Configure tab on their dashboard

ak15.png 

  • Click Job Board from the menu in the left hand column

 ak16.png

  • Click Developer Settings

 ak17.png 

  • You will see the Job Board URL and Job Board URL Token. Please copy and paste these into the corresponding field in the ARKiiV PRE-INTEGRATION QUESTIONNAIRE supplied

 ak18.png

INSTRUCTIONS FOR USING ARKiiV

Using ARKiiV could not be easier. It has been designed specifically to work with the Greenhouse platform and operates autonomously in the background. ARKiiV automatically searches for matching candidate resumes in your Greenhouse database and promotes relevant, matching jobs to them.


There’s no additional workload or training required, simply use Greenhouse in the normal way and ARKiiV takes care of the rest.

To use ARKiiV do the following:

  • The Greenhouse user Creates / Adds a New Job in the normal way
  • The job posting needs posted to the Company Careers Site / Job Board

ak20.png 

  • Once the job has been created the user navigates to the Job Posts section by clicking the link in the menu on the right hand column of the Job Dashboard

ak30.png 

  • The user needs to set the job to live

 ak40.png 

  • ARKiiV automatically checks for new jobs posted every hour 
  • For each new job ARKiiV automatically searches the clients Greenhouse resume database looking for relevant, matching candidates. 
  • ARKiiV sends an email notification to the Greenhouse user who posted the job with results of the search 

ak50.png 

  • ARKiiV automatically sends targeted email notifications to relevant, matched candidates with details of the newly created job and a link to view and apply for the job on the Greenhouse hosted Company Careers Page / Job Board.

 ak60.png 

  • Candidate can click on the application link to view and apply for the job on the Company Careers Site / Job Board

 ak70.png

 

CUSTOMISATION & RECOMMENDED SETTINGS

Recommended Settings

Whilst not a mandatory requirement for the ARKiiV solution we would HIGHLY RECOMMEND the following settings are enabled with the Greenhouse Configurations. 

  • When creating a candidate, make "Resume" a required field
  • When creating a job, make "Office" a required field

To configure recommended settings

  • The Greenhouse user will go to their Configure tab on the dashboard

ciiv1.png 

 

  • Click Permission Policies from the menu in the left hand column or the main menu options in the centre column

 ciiv2.png

  • Click the Checkbox (tick) to ensure the permissions are selected. These settings will be saved automatically

 ciiv3.png

  

Customisation

ARKiiV can be configured and customised for Greenhouse Company customers. For Example customers may use Custom Fields or Tags to specify candidates who should not be contacted. These custom fields can be incorporated into the ARKiiV solution for that customer. Please discuss any customisation requirements with your CiiVSOFT Account Manager.

 

PLEASE NOTE: Customisation is subject to additional costs and setup fees. Please speak with your CiiVSOFT Account Manager to receive pricing information and a quotation.

 

 

 

Have more questions? Submit a request

Comments

Powered by Zendesk