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.

Create a Harvest API key for the Personio integration

To configure the Greenhouse Recruiting / Personio integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Personio integration.

Credentials

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

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

Permissions

Verify that the following permissions are selected for the Personio integration:

Custom Fields

  • Select all

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, 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 are the same, 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.

Click Copy on the webhook URL. You'll need this value in the next step.

Configure a webhook in Greenhouse Recruiting

To integrate Personio 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:

  • Name: A descriptive name for your integration. Most customers choose 'Personio integration'
  • When: The time that the event will be sent to Personio. Select the following options for this integration:
    • Candidate is hired
  • Endpoint URL: The webhook URL from Personio
  • Secret Key: A word or phrase to authenticate the webhook

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 by navigating to Settings > Marketplace > Greenhouse.

Additional resources

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