CareerBuilder Applink is a free integration service that allows you to seamlessly send applicants from CareerBuilder to an ATS like Greenhouse Recruiting. Applink also allows for a simple, intuitive and mobile-optimized application process for job seekers that ensures you receive all of the intended applications. Greenhouse Recruiting’s integration with CareerBuilder Applink allows your organization to push candidates from CareerBuilder Applink into Greenhouse Recruiting. In this article, we will cover how to:
- Configure User Setup Permissions in Greenhouse Recruiting
- Create a Harvest API Key for the Greenhouse/CareerBuilder Applink Integration
- Retrieve Greenhouse Recruiting User ID
- Create Greenhouse Recruiting Custom Source Field
- Create Greenhouse Recruiting Custom Candidate Fields
- Enable Greenhouse/CareerBuilder Applink Integration
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/CareerBuilder Applink 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 CareerBuilder Applink.
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 Candidates
- GET: List Candidates
- PATCH: Edit Candidates
- 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
- Applications
- GET: Retrieve Application
- GET: List Applications
- PATCH: Update Application
- POST: Advance Application
- POST: Move Application
- Jobs
- GET: Retrieve Job
- GET: List Jobs
- Sources
- GET: List Sources
- Education
- GET: Get degrees
- GET: Get discplines
- GET: Get schools
When finished, click Update.
Navigate to your newly created Harvest API key and copy it, you will need to share this key with CareerBuilder Applink in a subsequent step.
Retrieve Greenhouse Recruiting User ID
In order to push candidates from CareerBuilder Applink to Greenhouse Recruiting, CareerBuilder Applink will also need a Greenhouse User ID to attach to the pushed candidate's profile.
To find a Greenhouse Recruiting user's User ID, click the Configure icon in the upper right-hand corner and select Users from the left-hand panel.
Click Export to Excel. A spreadsheet will be downloaded onto your computer.
Open the Excel file and navigate to the User ID column. Select a User ID from the column that will be attached to any pushed candidates from CareerBuilder Applink.
You will need to share this User ID with CareerBuilder Applink in a subsequent step.
Create Greenhouse Recruiting Custom Source Field
In order to push candidates from CareerBuilder Applink to Greenhouse Recruiting, CareerBuilder Applink will also need a custom Source to attach to the pushed candidate's profile. For detailed instructions on how to create a custom source field, click here.
Create Greenhouse Recruiting Custom Candidate Fields
In order to push candidates from CareerBuilder Applink to Greenhouse Recruiting, CareerBuilder Applink will also need the following custom candidate fields to attach to the pushed candidate's profile:
- School
- Degree
- Discipline
Each of the above candidate fields should be a Single Select type with an Unknown option. Click here to learn more.
Enable Greenhouse/CareerBuilder Applink Integration
With all the necessary credentials and configurations, navigate to your CareerBuilder Applink account.
- Click on the Bento Box icon and select Admin Tools.
- Navigate to Company Admin and select Integration Configuration.
- Click Add Configuration under the Greenhouse ATS Option
- Enter your Greenhouse Recruiting API Credentials
- Select YES under the Activate Applink?
- Click Submit
A CareerBuilder team member will complete the rest of the fulfillment and notify your CareerBuilder Sales Rep that the integration is complete.