Darwinbox is a cloud-based HR platform built around the employee experience for three groups of users – HR/admins, managers, and employees. With customers in more than 100 countries, Darwinbox is the leader in supporting modern companies with global workforces.
Darwinbox offers strong solutions for HRIS, performance management, recruitment, talent management, and employee engagement. Businesses use Darwinbox’s advanced analytics and AI-driven insights to make data-driven decisions, optimize workforce productivity, and build a culture of continuous innovation and growth.
Darwinbox’s integration with Greenhouse Recruiting allows:
- Syncing organizational masters data (office locations and departments) from Darwinbox to Greenhouse.
- Addition of candidate from Greenhouse to Darwinbox as an employee in pending/active state.
- Addition of candidate education details in Darwinbox.
- Tagging the cover letter and resume to the employees' profile which was created.
Set up the Darwinbox integration
Create a Harvest API key
To configure the Darwinbox integration, you’ll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Darwinbox integration.
Credentials
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: Darwinbox or Unlisted Vendor
- Description: Darwinbox Harvest API Key
Permissions
Verify that all of the available permissions are selected for the Darwinbox integration API key. This is required in order to fetch all the required details from the Harvest API. Be sure to copy the API key as you will need to enter it in Darwinbox in a later step.
Navigate to Darwinbox to configure the integration templates. Click on the Configure button and you’ll be redirected to a configuration page.
Set up Department and Office sync
In Darwinbox, click on Configure, then Create Integration Template.
Add the basic details like Template Name, Greenhouse API details and Internal Darwinbox API details to enable the integration.
- Greenhouse Username: The Harvest API key. Paste the key you created in Greenhouse.
- Greenhouse Admin User ID: the user ID of the Greenhouse user(s) that will be used as on-behalf-of users header in the Harvest API call. This user will be credited for the actions the integration takes.
- Mongo ID of custom field holding Greenhouse ID in Darwinbox: the placeholder where the Office/Department IDs’ will be stored in Darwinbox.
A standard code-base will also be provided to the user where they can oversee the code flow and if required can also customize if they need to incorporate any custom logic. After entering the details the user can click over the “SAVE“ button and enable this integration at Darwinbox.
Additionally, the user needs to make a choice if they want to make full sync (which will be one time) or delta (which will be synced on daily basis) by entering “1” for full sync and “2” for delta sync. Create a Webhook
To integrate Greenhouse Recruiting’s candidate data with Darwinbox, 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: Darwinbox Add Candidate Integration (Candidate has been hired)
- When: Candidate has been hired
-
Endpoint URL: Darwinbox custom API’s endpoint that can be created in the Darwinbox environment itself. Example:
https://{{sub-domain}}.darwinbox.com/studioapibuilder/green-v1.0/house - Secret Key: Darwinbox
- Advanced settings
- Username: Darwinbox custom API’s endpoint username
- Password: Darwinbox custom API’s endpoint password
-
Additional HTTP Headers: Add the custom parameter as
custom-api-key:eb7068b61XXXXXXXXXXXXXa60f11acc85affedf441d1
You’ll obtain the value for “custom-api-key” from the Darwinbox Studio Module, on the Darwinbox API Keys section
Permissions
Verify that all of the available permissions are selected for the Darwinbox integration. This is necessary in order to send all the required details to the Webhook. Be sure to configure the Darwinbox API key with the required credentials in the webhook configuration
Set up hired candidate sync to Darwinbox
The Greenhouse integration template needs to be enabled on Darwinbox, to configure the template, click on “Configure“ button and you’ll be taken to a configuration page.
In Darwinbox, click on Configure, then Create Integration Template. Add the basic details like Template Name, Greenhouse API details and Internal Darwinbox API details to enable the integration. A standard code-base will also be provided to the user where they can oversee the code flow and if required can also customize if they need to incorporate any custom logic. Post entering the details the user can click over the “SAVE“ button and enable this integration at Darwinbox.
The following list of fields can be included in the scope of the integration (the attributes can vary as per the organization’s requirements:
Use the Darwinbox integration with Greenhouse Recruiting
After marking the candidate as hired on Greenhouse, the configured Darwinbox API will be called and will trigger the above-mentioned configuration. After running the job successfully, an email will be triggered to the required HR point of contact, notifying that the candidate has been successfully added as pending employee with a Greenhouse unique ID.
Additional resources
For additional information not covered here, reach out to your Darwinbox Account Management team.