Setting up the Lever integration

p ackages basic basic | | standard standard | premium available as an add on this section covers the process for setting up your lever requisitions integration app to begin migrating requisition data between lever and charthop setting up the lever requisitions integration app requires the following steps create a lever api key install the lever integration app set up the api connection set up the flow of requisition data set up the flow of new hire data ats integrations are typically done with help from charthop's professional services contact your implementation specialist before beginning these steps create a lever api key in order for charthop to access your organization's lever recruiting data, you need to create a lever api key that you can use with charthop you can work with your lever requisitions administrator if you have questions to create your api key, follow the steps outlined in the https //help lever co/hc/en us/articles/360042364412 generating and using api credentials use the instructions in the lever documentation t o create your api key and use the following values when doing so field value key name charthop select a preset select all read description leave th is blank after you name your key and ena ble all of its read permissions, you need to configure the key’s write permission s enable the following write permissions create requisitions delete requisitions update posting update requisition fields install the lever integration app once you've created your api key in lever, you can install the lever integration app in charthop to install the lever requisitions integration app from the left sidebar, select apps & bundles from the sub menu, select apps select the availible apps tab scroll the list down to the lever requisitions app select install select install from the app install page set up the api connection in order to allow charthop to access your lever data, enter your lever api credential in the lever requisitions api key field in the settings section of the app then, select save settings set up the flow of requisition data once you establish your api connection, you can configure the type of requisition data flow that the integration runs select your source of truth when setting up your integration, you can choose the primary source of truth when referencing new requisition data selecting charthop results in an outbound job data flow where charthop is the source of truth, whereas, selecting remote system (lever requisitions) results in an inbound job data flow where the ats is the source of truth to select your lever requisitions integration’s source of truth from the left sidebar, select apps & bundles from the sub menu, select apps select the installed apps tab scroll the list down to the lever requisitions app select the lever requisitions app from the charthop lever requisitions app settings page, scroll down to the source of truth section select one of the two options charthop charthop is the source of truth and the integration is configured to run an outbound job data flow remote system (lever requisitions) lever is the source of truth and the integration is configured to run an inbound job data flow configure the lever requisitions integration you can configure the lever requisitions integration app to handle two types of data migrations (job data flows) between charthop and lever requisitions depending on the type of job data flow you choose, you may enable specific configurations that may either be required or optional and yet, recommended these are the required and recommended configurations for each job data flow job data flow type configurations outbound, charthop to lever required sync on change recommended run daily inbound, lever to charthop required reverse sync recommended run daily remote location as default to and change the configuration options for your lever requisitions integration from the left sidebar, select apps & bundles from the sub menu, select apps select the installed apps tab scroll the list down to the lever requisitions app select the lever requisitions app from the charthop lever requisitions app settings page, scroll down to the other options section select from the following configuration options described in the table below after you select your integration’s source of truth, you can select additional options to further customize and configure it field description run daily with this option enabled, the ats app runs automatically every day when enabled, regardless of data direction, job related candidate metrics are pulled on a daily basis every morning for customers on the inbound job data flow direction, this also causes the inbound job data flow to run on a daily basis every morning sync on change enables the outbound job data data flow direction when enabled, changes to open jobs are automatically pushed to lever as soon as they are made in charthop this option cannot be selected when reverse sync is enabled reverse sync when enabled, lever becomes the system of record, and charthop is updated with new open roles from lever when the inbound job data flow runs this option cannot be selected when sync on change is enabled reconciliation when enabled, reconciles lever role and field data with charthop, treating charthop as the source of truth for example, if an open job exists in charthop but not in lever, a matching req is created in lever reconciliations can either happen on an ad hoc basis or on a daily basis if the run daily option is enabled this option cannot be selected when reverse sync is enabled remote location as default when enabled, newly synced records that are not assigned a location are assigned the value remote location set up the flow of new hire data you can use the new hire webhook job data flow to automatically bring new hires from lever to charthop when the candidate is marked as “hired” in lever, along with their relevant personal information, such as address, phone number, and email new hire webhooks will not be processed if the person being hired already exists in charthop, even if they aren’t actively in a role as a result, the integration cannot support internal transfers re hires only the first new hire webhook for a charthop job is supported for example, if they you update an offer packet and re hire the candidate in lever, the updated information will not be processed in charthop unless the new hire in charthop is removed first a new hire webhook will not be processed if the job does not exist in charthop all new hire webhook job data flows are inbound (lever to charthop) copy your created api key to enable your web hook in lever to configure the new hire webhook job data flow, follow the steps below in charthop from the left sidebar, select apps & bundles from the sub menu, select apps select the installed apps tab scroll the list down to the lever requisitions app select the lever requisitions app from the charthop lever requisitions app settings page, copy the secret key value under webhook setup in lever navigate to integrations and api under settings select webhooks enable candidate hire to on add the webhook select verify connection with the webhook enabled, accepted offers in lever are pulled into charthop, alongside the new hire's start date, and contact information