This article explains how to set up the Greenhouse integration with Personio. When connected, the Greenhouse integration automatically sets up new employees in Personio once a candidate's status in Greenhouse is marked as Hired. The integration allows specific attributes in Personio and Greenhouse to be synchronized, so Personio can import the corresponding information into your account.

Pre-requisites for a successful integration

Before beginning the integration process, ensure the following is in place:

• You have an admin role or editing rights for the Marketplace in Personio via Settings > People > Employee Roles > Access rights > Account configuration > Marketplace integration.
• You have access to the Dev Center (Developer Permissions) in Greenhouse.
• The Tray.io, Inc checkbox is activated via Settings > Support > Subscription & Billing > Data Protection Information.
• The attributes First name, Last name and Email address are populated in Greenhouse for a successful exchange of information.

Connect and authenticate Greenhouse

Set up the Greenhouse integration directly in Personio's Marketplace with the Configuration Wizard. This requires you to generate an API Key in Greenhouse, which you then enter in Personio. Follow these steps:

1. Go to Marketplace in Personio, then search for and select the Greenhouse integration.
2. Click Connect to open the Configuration Wizard.
3. Log in to your Greenhouse account.
4. Create an API key in the Greenhouse API Credential Management area. These steps are outlined in step one of the Configuration Wizard in Personio.
5. Once generated, enter the API key in the Greenhouse API Key text box in the Personio Configuration Wizard.
6. Click Next to go to step two of the Configuration Wizard and Authenticate Personio.

Note
Store your Greenhouse API key securely. If you lose it, you will need to create a new one.

Authenticate Personio

Step two of the Configuration wizard requires you to grant the Greenhouse integration access to the necessary Personio data. Follow these steps:

1. Review the permissions that the Greenhouse integration requires.
2. Click Next to continue to step three of the Configuration Wizard and Map attributes.

Tip
You can review the granted permissions after the setup process by going to Settings > Integrations > API credentials and selecting the Greenhouse integration.

Map attributes

In step three of the Configuration Wizard, you can select which Greenhouse attributes should be synchronized, or aligned, with Personio. Follow these steps:

1. Review all the attributes and ensure that each Personio attribute matches the corresponding Greenhouse attribute.
2. Click Add new attribute to include more attributes.
3. Click Next to continue to step four of the Configuration Wizard, Create a web hook.

Note
If you are mapping attributes of the type List of options or Tags, make sure that the attribute values are identical in Personio and Greenhouse.

Create a web hook

In step four of the Configuration Wizard, you need to create a web hook. To create a web hook, follow these steps:

1. Return to the Web Hooks section of the Greenhouse Dev Center, and follow the instructions on the Greenhouse page.
2. Reference the steps outlined in Personio's Configuration Wizard for additional instructions.
3. Enter the Endpoint URL in Greenhouse by clicking the Copy link button below the steps in the Configuration Wizard. Paste the link in the Endpoint URL box. 
4. Continue to follow the steps in the Configuration Wizard to finish creating the web hook.
5. Click Finish. 
6. Return to the Greenhouse Dev Center and enable the web hook.
   • Under Edit Web Hook, click the pencil icon next to the webhook you want to enable.
   • Under Deactivated?, select No.
   • Click Update Web hook.

The integration set up is complete.

Note
If you reactivate the Greenhouse integration, you need to create a new webhook. The previous webhook will not work anymore.