Greenhouse Recruiting’s integration with Dice.com allows recruiters to effortlessly prospect relevant candidates for their tech-focused jobs. The integration automatically determines the best candidate matches based on your job description and adds them as a prospect to your job order and Greenhouse CRM. Recruiters can tailor the prospect results by adjusting the employment type and required skills fields in their job details. Maximize your sourcing activities and breakthrough to proactive sourcing with Dice IntelliSearch for Greenhouse.

See the following sections for more information:

Configure user setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Dice 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/Dice 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 Dice.com

In the Create New Credential dialog box, make the following selections:

  • API Type: Harvest

  • Partner: Dice

  • Description: Dice Harvest API Key

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Dice.

In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Dice in the next step.

Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

API permissions

On the subsequent page, confirm the following permissions are assigned to your new API key and select the following permissions:

Applications

Permission

Description

Get: Retrieve Applications

Allows Dice to check what prospect job applications were previously sourced by Dice IntelliSearch

Get: List Applications

Patch: Update Applications

Allows Dice to associate a prospect to the associated job

Candidates

Permission

Description

Get: List Candidates

Allows Dice check whether we previously imported a prospect to Greenhouse so that we can avoid creating a duplicate

Post: Add Candidate

Allows Dice to add a new prospect to your Greenhouse database

Patch: Edit Candidate

Allows Dice to update a prospect profile for which we have a newer prospect resume

Post: Add Note

Allows Dice note the candidate’s desired salary and likeliness to switch

Post: Add Attachment

Allows Dice to add a resume profile to the prospect job application

Post: Add Application

Allows Dice to add another prospect to an existing prospect in cases where the prospect is a good match for multiple jobs

Post: Add Employment

Enhances the prospect profile with previous employment information from Dice.com

Jobs

Permission

Description

Get: Retrieve Job

Allows Dice to check whether it should find prospects for a particular job

Patch: Update Job

Allows Dice to add a job note if IntelliSearch is unable to find any new candidates.

Job Posts

Permission

Description

Get: List Job Posts

Allows Dice to get the job posting information that it needs to run an IntelliSearch agains the Dice database.

Get: Retrieve Job Post for Job

Get: List Job Posts for Job

Sources

Permission

Description

Get: List Sources

Allows Dice IntelliSearch to find it’s source id value so that Dice IntelliSearch can determine how many candidates it previously sourced for a particular job

Prospect Pool

Permission

Description

Get: List Prospect Pools

Allows Dice IntelliSearch to find the pool and pool stage id that it needs to send new prospects to.

When finished, click Save.

If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished.

Your Harvest API key for the Greenhouse/Dice integration is created and configured. Your Harvest API key will need to be provided to your Dice customer success representative so they can set up the integration.

Configure Custom Greenhouse/Dice Integration Fields

The Dice integration utilizes the following custom fields in your Job Order to intelligently source prospective candidates.

  • Dice IntelliSearch

  • Dice IntelliSearch: Required Skills & Keywords

  • Employment Type

To enable these fields in your job, click the Configure icon in the upper right-hand corner and navigate to Custom Options on the left-hand panel.

From the Custom Options page, click Jobs under the Company Custom Fields Section. On the next screen select Add Field to create a new field.

Custom Field Setup

The following custom fields will need to be configured in your Job Fields section:

Dice IntelliSearch

From the Add Field Selection enter the following inputs for each field:

  • Field Name: Dice IntelliSearch

  • Description: Allows Dice IntelliSearch to automatically prospect the most relevant candidates from Dice.com directly to your Greenhouse job

  • Field Type: Yes/No

The Immutable Field Key value for Dice IntelliSearch will need to be provided to your Dice customer success manager.

Example:

Graphical user interface, text, application, email

Description automatically generated

Dice IntelliSearch Required Skills & Keywords

From the Add Field Selection enter the following inputs for each field:

  • Field Name: Dice IntelliSearch: Required Skills & Keywords

  • Description: Comma separated list of required keywords for the Dice IntelliSearch. Filters out prospect who don't have all the listed keywords in their profile resume. When specifying variations of skills and keywords, add brackets around them with an “OR” between each word.

  • Field Type: Short textbox

The Immutable Field Key value for Dice IntelliSearch Required Skills & Keywords will need to be provided to your Dice customer success manager.

Example:

Graphical user interface, text, application, email

Description automatically generated

Employment Type (if applicable)

Your organization should already leverage an Employment Type field that designates the type of employment for your jobs, your Dice customer success manager can work with you to map your employment type field values to Dice’s employment type filters.

Example:

Graphical user interface, application

Description automatically generated

You must map your Greenhouse employment type values to Dice employment values and provide the following table to your Dice customer success manager.

Note: Multiple Greenhouse employment types can be associated with a single Dice employment type, and a single Greenhouse employment type can be associated with multiple Dice employment types.

Dice Employment Types:  

Greenhouse Employment Types: 

Contract 1099 

 

Contract Corp to Corp 

 

Contract W2 

 

Contract to Hire 1099 

 

Contract to Hire Corp to Corp 

 

Contract to Hire W2 

 

Full Time 

 

Part Time 

 

The Immutable Field Key value for employment type and the mapping above will need to be provided to your Dice customer success manager.

Salary (if applicable)

Your organization may leverage a Salary field that designates a max salary or salary range. If you would like the integration to filter out candidates based on the job’s salary, please provide the Immutable Field Key value to your Dice customer success representative.

Example:

Graphical user interface, text, application, email

Description automatically generated

Configure Dice IntelliSearch Source

The prospect applications created by the integration will need to be attributed to “Dice IntelliSearch” as the source.

To create a new source value, click the Configure icon in the upper right-hand corner and navigate to Custom Options on the left-hand panel.

From the Custom Options page, click Sources under the Company Metadata Section. On the next screen select Create New Source. Then select Prospecting as the Sourcing Strategy and Dice IntelliSearch as the Name of Source

Graphical user interface, website

Description automatically generated

Notify your Dice CSM

You’ll need to inform your Dice customer success manager and include the following setup information:

Harvest API Information

  • Harvest API Key: Please send in a secure manner to your CSM
  • Desired On-Behalf-Of user id:

This user will be the primary Greenhouse user that the API Key will work “on behalf of.”

To find the user id value, click the Configure icon in the upper right-hand corner and navigate to Users on the left-hand panel.

From the Users page, search for the user that you want the integration to work on behalf of. Click on the name of the user. Provide the user id from the browser URL to your Dice customer service representative

To find your own user id value search for your user and then click Export to Excel. You will find your user id in column A next to your last name

Graphical user interface, text, application, chat or text message

Description automatically generated

Field Information

Immutable Field Keys for the following custom fields

  • Dice IntelliSearch:
  • Dice IntelliSearch: Required Skills & Keywords:
  • Employment Type:
  • Salary:
  • Greenhouse Employment Type Mapping: See page 10
  • Source Name:
  • Prospect Pool Name:
  • Prospect Pool Stage:

Dice API User Email

You will need to create an email distribution list or an email alias for the Dice API User. The email will need to route to an actual person and will be utilized to set and reset the password for your Dice API User. The user email must follow the naming convention below:

{companyName}.gh.api@{companyDomain}.com

Inform your Dice customer success manager once you have setup the Dice api user email alias for your organization.

Dice will provide an additional link once the Dice API User is setup. This link allows you to register your newly set Dice API User with the IntelliSearch for Greenhouse integration.  

Additional Integration Configurations

  • Days Last Active Setting:
    • Value: number – Filters out any prospects that haven’t been active in Dice.com within the specified days
    • Example: If Days last active is set to 90, then the integration will only find persons that have been active on Dice in the past 90 days
  • Exclude Third Party Filter:
    • Value: true/false – When set to true filters out any prospects that are being represented by a third-party agency
  • Require Phone Number Setting:
    • Value: true/false – When set to true will filter out any profiles that do not have a phone number
  • Maximum Prospects Per Job: 
    • Value: number – Determines how many profiles are sourced per job order
    • Once you email your Dice customer success manager with the setup information above, Dice will send you a Dice API user registration email so that you can connect your Dice API user to the IntelliSearch for Greenhouse integration

Enable Greenhouse/Dice Integration Web Hooks

The last step in the process is to enable integration web hooks for the integration so that it can automatically source on your behalf based on actions you take in your Greenhouse UI.

Retrieve Dice’s Endpoint URL and Secret Key For Web Hooks

Before enabling the Greenhouse/Dice integration, Greenhouse will need two pieces of information:

  • Dice’s Endpoint URL

  • Dice’s Secret Key

Your Dice Customer Success Representative will provide you and email with the Endpoint URL and Secret Key once Dice completes its integration setup.

Configuring Greenhouse Webhooks

With Dice’s endpoint URL and Secret Key copied, and your Greenhouse user permissions enabled, you are ready to enable the Greenhouse/Dice integration.

To enable the integration, click the Configure icon in the upper right-hand corner and navigate to Dev Center on the left-hand panel.

Graphical user interface, application

Description automatically generated

From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page.

Graphical user interface, application

Description automatically generated

You will be directed to a new page where you Create a New Web Hook. From this page provide the following details:

  • Name: we suggest the following for the 4 configured webhooks:
    • diceApplicationUpdated
    • diceJobUpdated
    • diceJobPostCreated
    • diceProspectRejected
  • When: Be sure to select the right web hook so that the web hook fires at the appropriate event in Greenhouse. The following webhooks need to be created for the integration
    • Application Updated
    • Job Updated
    • Job Post Created
    • Candidate or Prospect Rejected
  • Endpoint URL: The Endpoint URL provided by the Dice Customer Success team
  • Secret Key: The Secret Key provided by the Dice Customer Success team

When finished, click Create Web hook.

Graphical user interface, text, application

Description automatically generated

That's it! Your IntelliSearch for Greenhouse integration is ready to use.

How to use the Dice Integration with Greenhouse

The IntelliSearch for Greenhouse integration is very simple to enable. Simply set the Dice IntelliSearch field to Yes in the Job Information for any Open job.

Once set to Yes, the IntelliSearch for Greenhouse integration will use the following field information to match and import relevant prospects to your job from Dice.com:

Job Post Fields

  • Job Name: Ensure that your job name is indicative of the job need
  • Location: IntelliSearch will find persons within a 50-mile radius of the location specified
  • Post Description: Well-written job post descriptions are critical to good results. IntelliSearch will read from the text to determine the needed skillsets to look for in its database

Job Info Fields

  • Dice IntelliSearch: Required Skills & Keywords: Listing the required skills and/or keywords for this job ensures that the prospects returned have all the needed criteria. The product by default will convert any comma-separated values to an AND statement. Recruiters may indicate variations of skills and keywords by placing them in brackets and typing an OR between each.
    • Example: The following input would require prospects to have Java or C++ experience and AWS or Azure experience and DBA experience.
    • (Java OR C++), (AWS OR Azure), DBA
  • Employment Type: The employment type is critical to filter out any prospects not suited for the type of work being completed.
    • Example: If you are looking for a Contract position, setting the Employment Type to Contract would filter out prospects that are looking for contract engagements

The integration takes between 2-7 minutes to return candidates once it is enabled. Furthermore, the number of candidates found for each job is configurable for the integration so that your database is only filled with the most recent and relevant candidates from Dice.com.

Please designate a single on-behalf-of user that we will attribute the create and update prospect activities to via the integration.

Interacting with Prospect Results

Greenhouse Recruiting enables you to interact with prospects in a mirid of ways. You may now search for the prospects within the All Candidates search, see the prospects from your Job Dashboard, or interact with them through your Greenhouse CRM.

All Candidates Search

As Dice IntelliSearch for Greenhouse grows your internal database of relevant candidates, you can directly search for prospects by setting the Application Type to Prospects only.

Graphical user interface, text, application, email

Description automatically generated

Furthermore, Dice enriches each greenhouse candidate record with an extensive list of candidate skills by adding them as Candidate Tags. This allows you to easily narrow your internal Greenhouse prospect search by specifying important skills in the Candidate Tag field

Graphical user interface, application

Description automatically generated

Job Dashboard

Dice IntelliSearch for Greenhouse matches prospects directly to your job. These top matches are added as Current Prospects to your Greenhouse Job.

Graphical user interface, application

Description automatically generated

Selecting Current Prospects will direct you to a pre-filtered candidate search based on your specific Job

Greenhouse CRM (optional)

Dice IntelliSearch for Greenhouse also works with your native Greenhouse CRM functionality by automatically adding auto sourced profiles into a prospect pool of your choice.

Graphical user interface, text, application, email, website

Description automatically generated

Note: The integration will only work with one designated pool.

If you would like to enable this, please supply your Dice Customer Success representative with the name of the prospect pool and prospect pool stage that you would like us to send the prospects to when they are found

Additional Prospects

When a recruiter makes an action to Convert to Candidate or Stop Considering as Prospect, Dice IntelliSearch for Greenhouse will automatically search for the next most relevant prospect in our database and backfill them to the job.

Graphical user interface, application

Description automatically generated

Support

Contact integrationsupport@dhigroupinc.com for troubleshooting assistance regarding the integration.