Cezanne HR is leading the way in delivering smart, sophisticated and cost-effective Cloud HR software to mid-sized businesses worldwide. Quick to deploy, easy to manage, and impressively flexible, Cezanne HR's comprehensive HR suite covers the complete employee lifecycle, from recruitment and onboarding through to payroll and performance.

Greenhouse Recruiting’s integration with Cezanne HR allows you to automatically add candidates to your Cezanne system when they are hired in Greenhouse Recruiting. In this article, we will cover:

 

Configure user setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / Cezanne HR integration, you need the developer permission Can manage and configure web hooks.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the web hooks permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon Configure.png  > Users > Your Name.

1._Configure_-_Users.png

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu. 

Select Can manage and configure web hooks so a check is in the checkbox. When finished, click Save.

Users_-_Can_manage_and_configure_web_hooks.png

Repeat as necessary for any other user who should have access to set up the integration.

 

Retrieve Cezanne HR's endpoint URL and secret key

Before enabling the Greenhouse Recruiting / Cezanne HR integration, you need two pieces of information:

  • Cezanne HR’s Endpoint URL
  • Cezanne HR’s Secret Key

To retrieve this information, navigate to Cezanne HR > Greenhouse integrations page. From this page, please check what is set in the Subdomain and Secret Key fields. If these settings have not yet been set up, please follow the steps below to configure these settings. 

How to set up a Greenhouse Recruiting / Cezanne HR integration in your Cezanne system

For this integration to be able to pull through successful candidates into Cezanne HR, you will need to ensure an 'Enter a New Starter' or 'Enter a New Starter (Without Absences)' Process is active (Administration > Processes > Employee Administration).

 For more information about how to set up these processes, see: Enter a New Starter Process.

image-3.png

You will then need to navigate to: Administration > Setup & Security > Integrations > Greenhouse.

The Details screen configures the subscription to Greenhouse and some of the details for a successful candidate's New Starter Process Task.

image-4.png

  1. Click Add New.
  2. Subdomain: Enter your company's Subdomain (e.g., CezanneHR). This field can be anything you want but will need to match the relevant field in Greenhouse and contain URL friendly characters.
  3. Secret Key: Enter a Secret Key. This will be used to setup the Greenhouse Recruiting webhook. This field can be anything you want but will need to match the Secret Key in Greenhouse Recruiting and must be secure.
  4. 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.
  5. New Hire Default Company: Search for the Company Code the successful candidate will be hired into.
  6. Click Save.

 

Enable Greenhouse Recruiting / Cezanne HR integration

With Cezanne HR’s endpoint URL and secret key copied, and your Greenhouse user permissions enabled, you are ready to enable the Greenhouse Recruiting / Cezanne HR integration.

To enable the integration, click the Configure icon Configure.png in the upper right-hand corner and navigate to Dev Center on the left-hand panel. From the Dev Center page, click Web Hooks

1._Dev_Center_-_Web_Hooks.png

Click Web Hooks from the subsequent page.

2._Web_Hooks_-_Web_Hooks.png

On the Create A New Web Hook page, provide the following details:

  • Name: Cezanne HR Integration
  • When: Candidate has been hired
  • Endpoint URL: The endpoint URL retrieved from Cezanne HR in the previous step
  • Secret Key: The secret key retrieved from Cezanne HR in the previous stepm

The endpoint URL will be https://w3.cezanneondemand.com/CezanneOnDemandapi/v4/greenhouse/Webhook/Subdomain with the Subdomain part being replaced with the one you have set up in Cezanne. And the secret key will be the same as the one entered in the Secret Key field in Cezanne.

When finished, click Create Web hook.

image-7.png

That's it! Your Greenhouse Recruiting account and Cezanne HR account can now talk to each other. These settings dictate execution of the Cezanne HR web hook once the end user transitions the candidate into an appropriate application stage for a given job.

 

FAQs

Does the Greenhouse Recruiting / Cezanne HR integration have a cost?

The integration is available to all Cezanne HR customers and there is no additional cost.

Why hasn’t my New Starter Process Task been created?

The New Stater Process will not be created if any of the Greenhouse web hook details and Cezanne Integration details do not match but will still be created without a deployment or employment record if department or company cannot be found.

Solution:

  • Check the Subdomain is entered correctly in the Endpoint URL field in Greenhouse Recruiting
  • Check the Secret Key has been entered correctly 
  • Check that No has been checked under Disabled?
  • Check the candidate's Application Status in Greenhouse is Candidate has been hired

Why hasn’t the successful candidate’s Employment Details been created in Cezanne HR?

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.

Why hasn’t the successful candidate’s Deployment Record been created in Cezanne HR

A Deployment record will not be automatically created in the process if no Department has been entered in Greenhouse.

Solution:

  • The New Hire Administrator will have to add the Deployment details in the process.
  • Enter a Department in Greenhouse that matches an active Org Unit in Cezanne.

Why hasn’t the successful candidate’s Position Title been filled in Cezanne HR?

No Position Title will be entered on the Deployment Details tab in the New Starter Process if:

  • The Internal Job Name in Greenhouse does not match an active Position Title in Cezanne.
  • There are more than one active Position Titles in Cezanne that match the Internal Job Name in Greenhouse.

Solution:

  • The New Hire Administrator will have to add an active Position to the candidate's Deployment record in the process.
  • To prevent this happening again for any other successful candidates, ensure the Internal Job Name in Greenhouse matches an active Position in Cezanne.

Why hasn’t the successful candidate’s Address been filled in in Cezanne HR?

Address will not be filled in if there is no Address in Greenhouse or the address filled in was not recognized by Cezanne.

Solution:

  • Change the address in the Personal Information tab in the process.
  • Ensure there is a recognisable street address, house name and/or postcode.

 

Get Help

Please contact support@cezannehr.com for troubleshooting assistance regarding the integration.