Permissions: Job Admin or higher

Product tier: Available to all subscription tiers

Greenhouse Recruiting's integration with Personio allows you to automatically create new employees in Personio from hired candidates in Greenhouse Recruiting.

Configure user setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / Personio integration, you will need the developer permission Can manage ALL organization’s API Credentials.

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 API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon   > Users > Your Name.

Configure_-_Users_Master.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 ALL organization’s API Credentials so that a check is in the checkbox. When finished, click Save.

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

Create a Harvest API Key for the Greenhouse Recruiting / Personio integration

To create a Harvest API key for the integration, click on the Configure icon Configured_Icon.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

Configure_-_Dev_Center.png

From the Dev Center page, click API Credential Management.

Dev_Center_-_API_Credential_Management.png

Select Create New API Key.

Create_New_API_Key.png

In the Create New Credential dialog box, make the following selections:

  • API Type: Harvest
  • Partner: Personio
  • Description: Personio Harvest API Key

When finished, click Manage Permissions to generate the Harvest API key. 

Click Copy to save the API key to your clipboard.

API_Key_Created_-_Blurred.png

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

Select Save on the Harvest API page.

Enable the Greenhouse Recruiting / Personio integration in Personio

After you have generated the Harvest API key in Greenhouse Recruiting, you must enable the integration inside Personio.

Note: Before configuring the integration in Personio, you must have Personio API credentials. If you're using another integration with Personio, you may already have these credentials created. If you need to create credentials, navigate to you can do so in Settings > API > Access data > Download.

Navigate to Settings > Marketplace and look for the Greenhouse integration solution.

Click on the Connect Greenhouse button to start the integration wizard.

Paste your Greenhouse Harvest API key into the field and click Next

Add your Personio API credentials and click Next.

Next, synchronize the fields between Greenhouse and Personio by selecting the fields from the attribute dropdown menus.

By default, the candidate's first/last name, email, department, office, hire date and position are transferred. All the fields can be modified, but first and last name are required for integration. 

Note: Even if the attribute names between the applications, the options for each field must match exactly. For example, if an office is named "New York" in one system, and "new york" in the other, the integration will not work correctly.

When you're finished mapping the fields, click Next.

Configure webhook in Greenhouse Recruiting

Click Copy in Personio to save your webhook link.

In Greenhouse Recruiting, click the Configure icon Configured_Icon.png in the upper right-hand corner and navigate to Dev Center on the left panel.

Configure_-_Dev_Center.png

Select Web Hooks in the Dev Center and select Web Hooks from the list.

Webhooks.png

Enter the following information on the Create a New Webhook page:

  • Name: Personio Integration
  • When: The 
  • Endpoint URL: The webhook URL from Personio
  • Secret Key: A word or phrase to authenticate the webhook

When finished, click Create Webhook.

After the webhook is configured in Greenhouse Recruiting, click Finish in Personio to complete the integration.

Use the Personio integration with Greenhouse Recruiting

When a candidate in Greenhouse Recruiting is marked as hired, a new employee will automatically be created in Personio. The selected attributes will be mapped over to the new employee file.

After the initial configuration, you can map additional attributes in Personio under Settings > Marketplace > Greenhouse.

Additional resources

For information not covered here, reach out to Personio Support at support@personio.de.