Enabling and using the Cezanne HR integration

Available for Roles Super Admin, Admin, Team Member, Limited Team Member
Can only be enabled by Super Admins
Permissions • (To enable) Manage API credentials and manage integrations
• (To use) Manage profiles and view associated postings
Packages LeverTRM, LeverTRM for Enterprise

The Cezanne HR integration enables a successful candidate's record to be automatically created within the main Cezanne system and a New Starter Process task to be generated.


The Cezanne HR integration creates the following in Cezanne:

  1. A Person record in Cezanne with basic Personal Information and Contact Details. 
  2. The Person's Employment Details record, based on the Company Code specified in the Integration configuration.
  3. A New starter process task for a specified HR Professional (New Hire Administrator) for each successful candidate.

Setting up the Cezanne HR integration


You must be a team or organization with admin rights in Cezanne HR to install this integration.

Enable the webhook

  • In Lever, navigate to Settings > Integrations and API > Webhooks
  • Locate the 'Candidate Hired' webhook and toggle the webhook to the on (blue) position to enable
  • Select Add Webhook
  • Enter the following Webhook URL, making sure to replace [YOUR_SUBDOMAIN] with your Company Name, e.g. CezanneHR:
    • w3.cezanneondemand.com/cezannehr/api/v4/Lever/webhook/[YOUR_SUBDOMAIN]
  • Highlight and copy the signature token to a secure place; you will use this to configure the integration. 

Webhook configuration interface in Lever with URL and signature token fields outlined

Configuring the Cezanne HR integration


  • This integration only works if an 'Enter a New Starter' or 'Enter a New Starter (Without Absences)' Process is active in Cezanne HR. For more information about how to set up these processes, see New Starter Process.
  • The latest 'Enter a New Starter (with Absences)' Process created will be used first by the integration. If one cannot be found the latest 'Enter a New Starter (without Absences)' Process created will be used instead.
  • Navigate to Administration > Setup & Security > Integrations > Lever

Lever details

The 'Details' page configures the integration to Lever and some of the details for a successful candidate's New Starter Process.

Details page in Cezanne HR

  • Click Add New
  • Subdomain: Enter your company's Subdomain that you entered in the Webhook URL in Lever
    • E.g. CezanneHR
  • Signature Token: Enter the webhook Signature Token that you generated in Lever
  • New Hire Administrator: Search for a HR Professional User to be the person responsible for the New Starter Process; they will be sent the tasks to complete a successful candidate's New Starter Process
  • New Hire Default Company: Search for the Company Code the successful candidate will be hired into
  • Click Save
  • The New Hire Administrator field will have to be manually updated in Cezanne if the user leaves the company or their username changes
  • Only one default company can be entered, however a successful candidate's company can be changed in the New Starter Process by the New Hire Administrator
  • After clicking Save, a redirect will pop up; click OK to authorise the Lever integration

Redirect modal with OK button outlined

Authorize the integration

  • Log in to your Lever account

Lever login modal

  • Review the list of requested permissions; click Accept

App authorization modal with listed permissions

You will then be able to add candidates through Lever. If/when their status updates to 'Hired' in Lever, the successful candidates details will be pulled through onto Cezanne. For more information, see the Fields Sent to Cezanne section below.

Lever log

The 'Log' tab in Cezanne displays any information or errors that have occurred after hiring a successful candidate in Lever.

  • An Information message shows which person the integration has successfully started a New Hire Process for.
  • An Error message shows that a person's employment records have not been successfully created in the system and displays why. For more information about errors see the Troubleshooting section below.

Using the Cezanne HR integration

Fields Sent to Cezanne

Personal Information

Field Comments
First Name Sent from first part of the Full Name field in Lever.
Surname Sent from the last part of the Full Name field in Lever
Known As This will default to the name entered in the First Name field.
Full Name This will default to the name entered in the First & Last Name entered. 
Legal Name This will default to the name entered in the First & Last Name entered. 
Person Code Generated and sent by Lever.
Gender This field is not filled out in Lever, but is mandatory field in Cezanne so defaults to the Gender picklist item with code "U", which by default is set as 'Not Known'.
Date of Birth This field is not filled out in Lever, but is a mandatory field in Cezanne so defaults to Today's Date.
Home Number Sent from Work Number entered in Lever.
Work Number Sent from Work Number entered in Lever.
Mobile Number Sent from Mobile Number entered in Lever.
Other Number Sent from Other Number entered in Lever.
Skype Name Sent from Skype Name entered in Lever.
External E-mail Sent from main E-mail entered in Lever.



Field Comments
Hire Date This field defaults to Today.
Termination Date This field defaults to 'Open Ended'.
Employment ID This field will default to the same as Person Code.
Company Name This field is determined by the Company Code entered in the Cezanne - Lever details screen. See Configuring the Cezanne HR Configuration



This section contains a possible solution to problems that you may encounter when using the integration:


Ensure you have checked the log to find details on any errors that may have occurred.

Issue: New Starter Process task has not been created

The New Stater Process will not be created if the user account in Cezanne that has allowed access for the Lever integration has been deleted.

Solution: Check the New Starter Administration Account is still active in Cezanne
Once the problem is solved, you will need to kick off the New Starter Process:

  • Navigate to Lever
  • Move the candidate to a different stage
  • Then move the candidate back to 'Hired' again to kick off the process again.

Issue: Employment Details have not been created
Employment Details will not be created if...

  • The company is now inactive or has been deleted
    • Solution: Add the Employee details in the process - To prevent this happening for any other successful candidates, change the Default Company in the Integration screen to one that is active.
  • The company code has been changed 
    • Solution: Add the Employee details in the process - Manually update the Company Code to the current code in the Integration screen.

Disabling the Cezanne HR integration

  • Navigate to Settings > Integrations and API > Authorized Apps
  • Locate the Cezanne HR app
  • Click Revoke Access
Was this article helpful?
0 out of 0 found this helpful