ATS Sync Standard allows a seamless integration between CareerBuilder’s Talent Discovery Platform (TDP) and Greenhouse Recruiting to help recruiters find the most qualified candidates, regardless of where the candidate data resides. In this article, we will cover:
- Greenhouse/ATS Sync by CareerBuilder Overview
- Configure User Setup Permissions in Greenhouse Recruiting
- Create a Harvest API Key for the Greenhouse/ATS Sync by CareerBuilder Integration
- Enable Integration
Greenhouse/ATS Sync by CareerBuilder Overview
Reduce the amount of time it takes to find the right candidate by using powerful semantic search technology to search your private data and CareerBuilder data, including public CareerBuilder and Open-web resumes, in the same interface.
CareerBuilder’s ATS Sync Standard accesses the data within Greenhouse Recruiting, cleans and normalizes it, and makes it searchable from within the Talent Discovery Platform. This allows you to start your search process by unlocking the candidates who have already expressed interest in your organization resulting in faster hires. The ATS Sync also allows you to export any candidate data from the Talent Discovery Platform into Greenhouse Recruiting to take future action on viable candidates.
The integration enables you to:
- Pull: Import candidate profile and status data from Greenhouse into the Talent Discovery Platform
- Push: Export individual candidates and assign them to requisition IDs from the TDP to Greenhouse via the Export to ATS widget found when you select a candidate’s profile
Configure User Setup Permissions in Greenhouse Recruiting
In order to enable the 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.
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/ATS Sync Integration
To create a Harvest API key for the integration, click on the Configure icon in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.
From the Dev Center page, click API Credential Management.
From the API Credential Management page, click Create New API Key to generate the API key for the integration.
From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.
On the Manage API Key Permissions page, give the API key the following permissions:
- Candidates
- GET: Retrieve Candidate
- GET: List Candidates
- PATCH: Edit Candidate
- POST: Add Candidate
- POST: Add Attachment
- POST: Add Application
- POST: Add Prospect
- PUT: Merge two candidates
- POST: Add Education
- DELETE: Delete Education
- POST: Add Employment
- DELETE: Delete Employment
- Jobs
- GET: Retrieve job
- GET: List jobs
- Applications
- GET: Retrieve Application
- GET: List Applications
- PATCH: Update Application
- POST: Advance Application
- POST: Move Application
- Education
- GET: Get degrees
- GET: Get disciplines
- GET: Get schools
- Sources
- GET: List sources
When finished, click Update.
Navigate to your newly created Greenhouse Harvest API Key and click Copy.
Enable Integration
From the client’s recruiter desktop:
- Click on the bento box
- Select Admin Tools
- Hover over Company Admin in website toolbar
- select Integration Configuration
- Select Add Configuration for the Greenhouse ATS Option
- Enter client API Credentials
- Select ‘YES’ under the ‘Activate ATS Sync?’ question
- Click Submit
Greenhouse User ID:
For push purposes, ATS Sync requires a Greenhouse UserID that they will use to attach the candidates who will be pushed.
Customers can find the list of Users and their IDs by exporting them to an excel file:
Customers can find the usersIDs in a column called UserID (they will need these when they enter them in the CareerBuilder Portal