Double the amount of completed applications by integrating with CareerBuilder using Applink. CareerBuilder Applink is a free integration service that allows you to seamlessly send applicants from CareerBuilder to Greenhouse Recruiting, automatically formatting application data in your system. Applink also allows for a simple, intuitive, and mobile-optimized application process for job seekers that ensures you receive all of the intended applications to your job postings in Greenhouse Recruiting.
In this article, we will cover:
- Configure User Setup Permissions in Greenhouse Recruiting
- Create Harvest API Key for Greenhouse Recruiting / Applink by CareerBuilder Integration
- Retrieve Greenhouse Recruiting User ID
- Create Job Board API Key for Greenhouse Recruiting / Applink by CareerBuilder Integration
- Create Custom Source for Greenhouse Recruiting / Applink by CareerBuilder Integration
- Create Job Board Tracking Link in Greenhouse Recruiting
- Enable Greenhouse Recruiting / Applink by CareerBuilder Integration
Configure User Setup Permissions in Greenhouse Recruiting
In order to enable the Greenhouse Recruiting / Applink integration, you will need the developer permissions 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.
In addition to the Job Board API credentials permission, a single user configuring the integration should also have Site Admin level permissions or Job Admin level permissions with the additional user-specific permission Can manage company metadata.
Create Harvest API Key for the Greenhouse Recruiting / 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 disciplines
- 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 Recruiting 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 .xlsx 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 Job Board API Key for Greenhouse Recruiting / Applink by CareerBuilder Integration
To create a Job Board API key for the integration, click 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 Applink.
From the Create new credential dialog box, give your API key a name and select Job Board from the Type dropdown menu. When finished, click Create.
Your Job Board API key is generated and can be found under the Job Board API section. Navigate to the Applink Job Board API Key and click Copy.
Save your Job Board API key and send it to the CareerBuilder integration team.
Create Custom Source for Greenhouse Recruiting / Applink by CareerBuilder Integration
Click the Configure icon in the upper right-hand corner of the screen, then select Custom Options from the left-hand panel.
Select Sources from the subsequent page.
On the Manage Sources page, click Create New Source.
Use the subsequent dialog box to select Third-party boards from the Sourcing Strategy dropdown menu. Type CareerBuilder ATS Sync into the Name of Source field.
Click Create Source when finished.
Create Job Board Tracking Link in Greenhouse Recruiting
In addition to the Greenhouse Job Board API key and Harvest API key, your organization will need to create a job board tracking link to provide a tracking token to Applink.
Click on the Configure icon in the upper right-hand corner. Navigate to Job Board on the left-hand panel. From the Job Board page, click the three dots in line with the name of the job board for which you wish to create a tracking link, then click Tracking Link.
Set the Who gets credit dropdown to None, and the Select a source... dropdown to CareerBuilder ATS Sync.
The string of letters and numbers at the end of the tracking link is your tracking token. In the example above, the tracking token is cb1156a62. Copy and save the tracking token to provide to CareerBuilder.
Enable Greenhouse Recruiting / Applink by CareerBuilder Integration
To enable the integration, provide the Job Board API key, Harvest API key, User ID, and custom tracking link to the CareerBuilder team. They will complete integration setup, then notify your CareerBuilder Sales Rep when the integration is complete.