Bamboo HR Integration Guide

Activating the Integration 

• Contact your Criteria Corp Customer Success Manager about enabling the integration 
• Create the Candidate Status values in BambooHR 
• Create an Integration User 
• Activate integration via Criteria Platform 
• Configure Status and Job Mappings via Criteria Platform 
• Test the integration with a dummy candidate  

Create Candidate Status values in BambooHR 

Add statuses to be used by the Criteria integration. These status names are suggestions, you can use whatever status names make sense to your recruitment team. You will need to have these in place in BambooHR prior to activating the integration. 

If you plan to utilize 2 rounds of testing (e.g., 2 assessment packages or 1 assessment package and 1 video interviewing package), you will need separate status values for the round 2 testing. 

It is recommended to create 4 additional status values so you can easily distinguish candidates in the different rounds, however, only the 'Invite for Package' is required to be different from round 1. 

Suggested Status Names for Round 2 status values: 

• Criteria - Invite for Package 2 
• Criteria - Package 2 Invited 
• Criteria - Package 2 Completed 
• Criteria - Package 2 Completed - In Range  

In Bamboo go to Settings > Hiring > Candidate Statuses.  

Click + Add Status to create a new status. Repeat for each new status to add. 

Drag the new Status values to their logical order in your recruitment process.  

Create an Integration User (Optional) 

The activation process requires a BambooHR user to login and authenticate the integration. 

The integration will be tied to the BambooHR user who performs this process and that user must remain active in BambooHR for the integration to remain active. If that user is made inactive in BambooHR, the integration will stop working and another user will need to reactivate it to restore the integration.  

If possible, Criteria recommends you create a dedicated user in BambooHR to use in the activation process, so the integration isn't tied to a particular staff member. Give that user a name that indicates their purpose e.g., 'Criteria Integration'. 

Make a note of the username and password for this user as it will be required to activate the integration.  

Activate Integration via Criteria Platform 

Note: if you are currently logged into BambooHR, the integration will be automatically authenticated as that user. Log out of BambooHR before starting this process if you want to activate the integration using a different user. 

To connect your Bamboo account with your Criteria account, in Criteria go to Settings > Integrations.   

Click Enable in the BambooHR section.  

Enter your BambooHR subdomain and click Continue to BambooHR.   

Note: Your BambooHR subdomain is in the login URL of your BambooHR system. If your login URL for BambooHR is https://company.bamboohr.com, your subdomain would be “company”. 

You will be redirected to your BambooHR login page. Enter the credentials you'd like to use to authenticate the integration to complete the integration setup. Remember, this user must remain active in BambooHR for the integration to remain active.  

If you do not see this screen, it means you are already logged into BambooHR in this browser, and it has used that user to authenticate the integration. If you want to use a different user, log out of BambooHR then use the Edit link in Criteria to repeat this process straight away with the correct user. 

Once integrated, you will be returned to Criteria, and the message Enabled will appear.  

Configure Status via Criteria Platform 

Before you can use the integration, you need to tell Criteria what Status values you've set up in BambooHR to trigger Criteria assessments. 

In Criteria, go to Settings > Integrations. 

The Status and Job Mappings section will be blank until you add some configuration. Click Add Mappings to start the setup. 

Use the Default Status Mappings section to choose the status values you have set up in BambooHR for round 1 of Criteria assessments. (The first 3 status values are required.) Click Save. 

The main Integrations page will be updated to show the current configuration.  

Job Mappings via Criteria Platform (Optional) 

Note: A Criteria Package refers to the assessments and/or video interviews that are associated with a Criteria Job. 

If you'd like to set up your Criteria Packages and BambooHR Job Names to be exactly the same, you do not need to set up Job Mappings in Criteria. When a candidate is moved into the default status that triggers testing, the candidate will be invited to the Criteria package with the same name as the BambooHR job. 

However, if you'd like flexibility in the naming of your Criteria packages and BambooHR jobs, you can set up Job Mappings in the Criteria platform. The Job Mapping tells Criteria what package the candidate should be invited to, based on the BambooHR job they are in. The Job Mapping may also be used to adjust the status values used for that BambooHR job if you'd like to use a different workflow for a particular job. 

You may choose to just set up Job Mappings for the BambooHR jobs that require a variation from the default settings. Any BambooHR job without a Job Mapping in Criteria will use the name matching method. 

In Criteria, go to Settings > Integrations. 

The Mappings have been configured for line will show you how many job mappings are currently set up.  

Click Edit Mappings in the BambooHR section, then scroll down to the Job Mappings section to see the current mappings that are already in place. 

Note: If you use the same job names in BambooHR for each location, Criteria can update the integration to display the location names in Criteria to help you differentiate the jobs when setting up the job mappings. Please reach out to your Criteria Customer Success Manager and ask for the locations to be turned on in your Bamboo integration.  

Add a job mapping 

Use the + Add Mapping button to create a new job mapping. 

The first thing to choose is the BambooHR Job Opening this mapping is for. Choose the job from the drop-down. This list includes all Open Jobs from BambooHR. 

If you would like to utilize 2 rounds of packages for this Job Opening, toggle the round 2 setting to the On position. Using 2 packages will allow you to invite candidates to an assessment package and a video interview package, or 2 assessment packages, at different stages in the BambooHR workflow. 

Moving down the page, we can now configure the status values and the Criteria package for this BambooHR Job Opening. 

In the Round 1 Package section, choose the Criteria package to issue to candidates for this BambooHR Job Opening. You may also choose custom statuses for this job or stick with the defaults. 

Explanation of Fields: 

Round 2 is set up the same way as Round 1. The main difference is that the default status mappings only apply to round 1, so for round 2 you need to choose all the status values manually. 

The status to trigger the initial invitation for Round 2 must be different from the status for Round 1. The other status values may be the same in both rounds, however, to allow you to keep track of candidate progression, it is recommended that you create separate set of status values for round 2. 

Once all required fields have been selected, the Save button will become active. Click Save to create the Job Mapping. 

Criteria will no longer use job-name matching for this BambooHR Job Opening; this custom configuration will be used from now on.  

Edit a job mapping

Click on the name of a BambooHR Job Opening in the table to edit it or click the 3-dot icon and choose View/Edit Mapping. 

You will be able to edit the mapping using the same form as you created it. All fields are editable except for the BambooHR Job Opening.  

Click Save when you have completed making your changes. The changes will take effect immediately.  

Delete a job mapping 

Delete a job mapping by clicking the 3-dot icon on the right and choosing Delete Mapping. 

Click Delete in the confirmation popup. 

Since there is no custom mapping for the BambooHR Job Opening anymore, the integration will revert to finding a match on the job name instead.  

Using the Integration 

Inline Testing 

If you have configured a Job Mapping in Criteria that is associated with the 'New' status, candidates will be automatically invited as soon as they apply in that BambooHR Job Opening.  

Criteria will check for candidates in the 'New' status in that BambooHR Job Opening every 15 minutes. Candidates may appear in the 'New' status as a result of them completing an application form, or from a recruiter manually adding them into BambooHR.  

When a candidate is found, Criteria will process the candidate according to the Job Mapping configuration in Criteria and will send an invitation email to the candidate. The Criteria package settings will be used to apply the expiry date, invitation email template, time adjustments etc. to the new candidate. 

In BambooHR the candidate status will be updated to the appropriate "scheduled" status, and a note written against the candidate to indicate that the invitation was successful. 

Recruiter Initiated Testing 

If you have associated your integration with a specific BambooHR status in the workflow, other than the 'New' status, candidates will be automatically invited in Criteria when they are moved into that status. 

Your integration will have a default status set in Criteria, and each BambooHR Job Opening may have a custom configuration in place, so be sure to move the candidate into the correct status for that BambooHR Job Opening. 

Navigate to the Hiring menu and select a Job Opening. 

Locate the candidate you’d like to send the assessments to. You will need to change their status to the relevant status, according to your integration configuration in Criteria. 

You can either change their status using either of these methods:

1. Directly from the list screen by clicking on their current status and choosing the appropriate status from the drop-down list. 

   

2. Click into the candidate and change their status using the drop-down on the right-hand side of the candidate record screen. 

   

Criteria will check for candidates in your configured status within that BambooHR Job Opening every 15 minutes. 

When a candidate is found, Criteria will process them according to Job Name matching / Job Mapping configuration in Criteria and will send an invitation email to the candidate. The Criteria package settings will be used to apply the expiry date, invitation email template, time adjustments etc. to the new candidate. 

In BambooHR the candidate status will be updated to the appropriate "scheduled" status, and a note written against the candidate to indicate that the invitation was successful.  

Sending Assessments in Bulk 

Candidates in the same BambooHR Job can be invited in bulk by moving them to the appropriate stage all at once. 

Navigate to the Hiring menu and select a Job Opening. 

Check the boxes next to the candidates you’d like to send the assessment to. Click the Settings button and select Update Statuses. 

Select the appropriate status from the drop-down and click Save. 

A confirmation will appear at the top of the screen to confirm the candidates have been moved. The assessment invitations will be processed and sent the next time Criteria checks for pending invitations in BambooHR (up to 15 minutes). The Criteria package settings will be used to apply the expiry date, invitation email template, time adjustments etc. to the new candidates.  

Viewing Results - Assessments 

Once the Criteria package is completed, the results will appear in BambooHR immediately.  

The candidate will be moved into the appropriate Completed status, or the appropriate "Completed and score ranges met" status if they met all the score ranges. 

The candidate scores and a link to their Criteria score report will be available in their candidate record. Click the Notes tab and select Comments to access their results. 

The score data shown in the note will depend on the assessments completed by the candidate. The note will include the Talent Signal, whether they met the score ranges and the main overall score/s per assessment.  

Copy and paste the report link into your browser to see their full score report.  

Status updates and Viewing Results - Video Interviewing 

Once the candidate completes their video interview, the evaluators will be emailed to complete their evaluations.  

The Video Interview status will be available in their candidate record. Click the Notes tab and select Comments to see the status of the evaluations. 

The status will be 'Evaluation in Progress' and will display the number of evaluations as well as the minimum number of evaluations that needs to be reached before the score is generated.  

Copy and paste the report link into your browser to see the pending video interview report. Evaluators may click the button to login to Criteria and complete their evaluation. 

A new note will be created after each evaluator submits their evaluation.  

Once the minimum number of evaluators has been reached, the package will be considered completed and scores will be available. 

The candidate will be moved into the appropriate 'Completed' status. 

The candidate scores and a link to their Criteria score report will be available in their candidate record. Click the Notes tab and select Comments to access their results. The note will display the overall video interview score and the commendation from each evaluator. 

Copy and paste the report link into your browser to see their full score report.  

Video Interviewing Setup 

Your Criteria account will need to include Video Interviewing (VI) capabilities for you to configure jobs in Criteria with video interview. Your integration will also need to be enabled for Video Interviewing to allow you to access the video interview jobs/packages via BambooHR. Contact Criteria to have this set up. 

Configure the Criteria job/package with video interview (instead of a test battery) in the Incoming stage. 

If you have multiple video interview templates, you have a few setup options: 

• Basic - create a separate Criteria package for each video interview configuration.   

The integration will match on the job name or Job Mapping as per the configuration in Criteria. Each candidate invited to a specific Criteria VI package will complete the same interview template and the videos will be reviewed by the same evaluator/s.  

• Advanced - create a single Criteria package that will handle multiple video interview configurations.   
  When setting up Criteria Job Mappings, link all the BambooHR jobs to the same Criteria VI package. When a candidate is invited, the Bamboo Job Opening ID will be used to determine the appropriate configuration to use for that candidate. If there is no specific configuration for a BambooHR Job ID in Criteria, the default video settings will be used. Each candidate invited to the Criteria package may be invited using different VI template and/or evaluators if they originated from different jobs in BambooHR. 

To set this up, configure a Criteria job with the default VI template and evaluator/s, then activate the Configure Video Interview Configuration per ATS Requisition setting and add the Job ID values from BambooHR to have Criteria apply a different video interview template and evaluators per BambooHR role.   

• Mix and Match - you may use a combination of Criteria jobs with Basic and Advanced setups to suit your needs.  

Sample of Advanced Configuration setup in the Criteria platform: 

In this integration, the BambooHR Job ID should be used as the ATS Requisition Id. 

The BambooHR Job ID may be copied from the address bar while you are on the Job Opening page in BambooHR.  

Ongoing 

New BambooHR Job Openings 

When you add a new Job Opening to BambooHR, you may need to make an update in your Criteria account. 

If your BambooHR and Criteria jobs have the same names, when you add a new job to BambooHR with a name that hasn't been used before, you'll need to create a job in Criteria with that new name. 

If you are using Job Mappings, when you add a new job to BambooHR you will need to login to Criteria and add the mapping for that new job. 

Note: if you were already in the Criteria Settings > Integrations area before you added the new BambooHR job opening, the new BambooHR job opening may not be showing in Criteria yet. Return to the Settings > Integrations page in Criteria to refresh the job list and then click through to add the new mapping again. 

Edit Integration to use a different user or subdomain 

If you wish to use a different user to authenticate the integration or if your BambooHR subdomain changes, use the Edit link on the Settings > Integrations page in Criteria to complete the authentication process again. 

If the integration was disabled for a period of time, refer to Integration has stopped working in the Troubleshooting section to make sure you haven't missed any invitations/results.  

FAQ 

Why does the Status say ' (Inactive)'? 

"(Inactive)" will be displayed after the status name in Criteria if that status has been deleted from BambooHR. 

The status / job mapping won't work properly if it's using a status that is no longer valid. You will need to update the mapping/s in Criteria to use an active BambooHR status. 

Troubleshooting 

Integration has stopped working 

The user who activated the integration with their BambooHR login must remain an active user in BambooHR for the integration to continue working. If they leave the business, the integration will stop working as it was tied to their BambooHR user account. 

This is the most common cause for the integration to ceasing to work. 

Identify 

An easy way to check if this has happened is to login to Criteria and go to Settings > Integrations and check if the configuration has disappeared. 

1. Check if all the status values say, 'No Status Selected' and there are 0 mappings for BambooHR Job Openings. 

   

2. Click Edit Mappings and check if all the status drop-down options say, 'No results found'. 

   

If so, not to worry, it's easy for an active BambooHR user to re-activate the integration.  

Restore 

In Criteria, go to Settings > Integrations and click Edit in the BambooHR section. This will guide you through the activation process again. Refer to the Activate Integration via Criteria Platform section above to complete the process.  

If you haven't already, it is recommended that you create a dedicated user in BambooHR to use to activate the integration to avoid this issue again in the future.  

Once this has been done, the configuration should return automatically. Go to the Settings > Integration screen in Criteria and check if the current values are showing again. 

Confirm

Now that it's restored, some actions will be required to check it's working properly and get any missed results pushed through to BambooHR. 

• The candidates who are in the appropriate 'Invite candidate for Criteria Package' status in BambooHR will be automatically invited when Criteria next checks for pending candidates. To ensure the integration is working again, check back in 15 minutes to ensure that candidates have started to be moved to the appropriate 'Package has been scheduled' status in BambooHR. If there are a lot of candidates to process, it may take a few runs to process them all.  
  The easiest way to check this is to go to Hiring > Candidates in BambooHR and filter by the appropriate Candidate Status to see who is due to be invited. Make a note of how many candidates are in this list and then perform the same search again after 15 or more minutes and check the number has reduced.  
  Note: If the integration was disabled for an extended period, Criteria may not be able to see the candidates to invite. If the candidates are still in the appropriate 'Invite candidate for Criteria Package' status in BambooHR after a few hours, move them out of this status and then back into this status and Criteria should then be able to process them. If not, contact Criteria Support, explaining the situation and provide some example candidates' names to be checked.  
• Any candidates who completed testing while the integration was inactive will not have their results in BambooHR. Contact Criteria Support and explain what happened, provide the approx. date/time you think the integration became inactive and ask for the missed candidate results to be sent to BambooHR.  

New BambooHR Job Opening is not showing in Criteria 

If you were already in the Settings > Integrations area in Criteria before you added the new BambooHR job, the new BambooHR job may not be showing in Criteria yet. Return to the main Settings > Integrations page in Criteria as this will automatically refresh the Job Openings list from BambooHR; then try to add the new mapping. The new Job Opening should be shown now. 

When you add a new Job Mapping, only the BambooHR job opening without an existing mapping will be shown. If the job you are looking for is not in the drop-down, perhaps there's already a mapping for that job. Check the Job Mappings table to see if it's already in the list.