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:

Retrieve Cezanne HR's endpoint URL and secret key

Before enabling the Greenhouse Recruiting / Cezanne HR integration, you need two pieces of information to create the webhook in the next step:

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

To retrieve this information, navigate to Cezanne HR Greenhouse integrations.

From this page, copy the Endpoint URL (listed in the Subdomain field) and Secret key and store them in a safe location. 

If these settings have not been set up yet, please follow the steps below to configure both fields.

Set up the Endpoint URL and Secret key

For this integration to pull 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 

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

To begin, 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.

  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.

Create a webhook

To integrate Cezanne HR with Greenhouse Recruiting, you'll need to create a webhook. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhook(s).

  • Name: Cezanne HR Integration
  • When: Candidate has been hired
  • Endpoint URL: https://w3.cezanneondemand.com/CezanneOnDemandapi/v4/greenhouse/Webhook/Subdomain
  • Secret Key: The secret key retrieved from Cezanne HR in the previous step

That's it! Your Greenhouse Recruiting account and Cezanne HR account can now talk to each other. These settings dictate the execution of the Cezanne HR webhook once the Cezanne HR 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 webhook details and Cezanne Integration details do not match but will still be created without a deployment or employment record if the 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 from 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 from 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?

The address is not filled in if there's no address in Greenhouse or if 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 recognizable street address, house name, and/or postcode.

Additional resources

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