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 362,381 trueleft unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 259,484 false true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 137,606 false true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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