Greenhouse Integration Setup

In order to set up the Greenhouse Recruiting and Byteboard integration, you will need the following permissions across accounts:

To enable the Greenhouse integration, please visit Team Settings at https://client.byteboard.dev/settings/team. You will need to toggle the Greenhouse Integration button to on.

Once the Greenhouse Integration toggle has been turned on, you’ll find your Byteboard API key under the API Key heading under the Greenhouse Integration at https://client.byteboard.dev/settings/team.

1.1) Copy the API Key and visit your Greenhouse homepage at https://www.greenhouse.io/.

1.2) Click Get Help in the lower-left corner.

1.3) Type “Integration Setup” in the chat box, and then click Chat Now.

1.4) Once connected with an agent, write “I’d like to set up an integration with Byteboard” and they will respond with a link where you can provide your API Key.

1.5) The Greenhouse Support team will respond with a SendSafely link for you to enter your API Key. A notification will be sent to the Greenhouse Support Team after you have entered your API key, and they will email you to confirm that your API key has been set up in your account and your integration is enabled.

Once your Greenhouse Support team confirms that the Greenhouse Recruiting and Byteboard integration is enabled for your organization, you will be able to add the Byteboard CoreEval interview as an Interview stage. To add Byteboard CoreEval as an interview stage for an existing job:

1.6) Navigate to a job (All Jobs > Job Name) and click Job Setup from the Job navigation bar.

1.7) From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.

1.8) From the Add Stage dialog box, select the Byteboard stage. When finished, click Add to apply the stage to the job's interview plan.

Once the Byteboard stage has been added to the job's interview plan, click the Edit Interview icon button for that stage.

Use the provided drop-down menu to select the assessments that you have previously requested from Byteboard:

1.9) Select the appropriate assessment

1.10) Assign at least one Greenhouse user to review submitted assessments

1.11) When finished, click Save

2.1) Navigate to the API Credentials page (Configure → Dev Center → API Credential Management)

2.2) Click Create new API key. Set Type to Harvest, Partner to Byteboard, and Description to Byteboard Harvest or similar. Click Create.

2.3) Save the API key to a secure location

In Greenhouse, grant the following permissions and click Save after selecting

In Byteboard’s Team Settings > Greenhouse Integration Settings, enter your Harvest API Key under the Upload Your Harvest API Key, then refresh the Byteboard portal page before continuing on to 3. MAP JOB STAGES TO NEXT STEP CATEGORIES AND LIVE CODING STEPS .

If your Harvest API key has not yet been submitted via https://client.byteboard.dev/settings/team, the 3. MAP JOB STAGES TO NEXT STEP CATEGORIES AND LIVE CODING STEPS stage will show a “Waiting for API key” notification. If you see this, please return to 2. UPLOAD YOUR HARVEST API KEY before continuing.

Mapping Greenhouse job stages to Byteboard next step categories allows Byteboard to accurately track candidate performance and offer outcomes. For accurate reporting, you will need to map all Greenhouse stages in your job that could follow a Byteboard CoreEval interview even if these are not always used.

To map job stages in Byteboard:

3.1) Click Edit stage names to expand drop-down of your Greenhouse Stages.

3.2) To the right of the relevant Greenhouse Stage, select the corresponding Byteboard Stage for any interview stages following the Byteboard CoreEval interview

3.3) All other stages can remain unassigned. Once job stage mapping is complete, select Update stage names.

Web hooks set up allows Byteboard to track the status of your candidates after their interview. To set up web hooks:

4.1) Navigate to the Greenhouse web hook configuration page via Configure (Settings) > Dev Center > Web Hooks

4.2) Create the following web hooks with the the recommended stage names on the Web Hooks page

4.3) For each web hook created, select the web hook action under the When drop down that matches each value listed.

4.4) For the “Deactivated?”radio button, ensure No is selected (default selection).

4.5) Copy and paste the Endpoint URL and Secret Key from the Greenhouse Integration set-up in Byteboard.

4.6) Leave all other fields blank.

4.7) Select Create Web hook. Repeat for all other outstanding web hooks.

Please contact Byteboard at cs@byteboard.dev if you are interested in end-to-end testing and confirmation of set-up following completion of all setup steps.