Dice integration

Greenhouse Recruiting's integration with Dice.com allows recruiters to effortlessly post jobs, prospect relevant candidates, and receive applicants for their tech-focused jobs. The integration can post your jobs and automatically receive applicants. It will also determine the best candidate matches based on your job information and add them as a prospect to your job. Recruiters can tailor the prospect results by adjusting the employment type and required skills fields in their job details.

Create a Harvest API key for the Dice integration

To configure the Greenhouse Recruiting / Dice integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Dice integration.

Credentials

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

• API type: Harvest
• Partner: Dice
• Description: Dice Harvest API key

Permissions

Verify that the following permissions are selected for the Dice integration:

• Applications
  • GET: Retrieve applications
  • GET: List applications
  • PATCH: Update applications
  • POST: Add attachment to application
• Candidates
  • GET: Retrieve candidate
  • GET: List candidates
  • POST: Add candidate
  • PATCH: Edit candidate
  • POST: Add note
  • POST: Add attachment
  • POST: Add application
  • POST: Add employment
  • POST: Add prospect
• Jobs
  • GET: Retrieve job
  • PATCH: Update job
• Job posts
  • GET: List jobs posts
  • GET: Retrieve job posts for job
  • GET: List job posts for job
• Offices
  • GET: Retrieve office
• Sources
  • GET: List sources
• Tracking Links:
  • GET: Retrieve Job Tracking Link
• Users
  • GET: Retrieve User

When finished, click Save.

Copy your Harvest API key in a secure location so you can provide it to your Dice customer success representative.

Create custom fields for the Dice integration

The Dice integration utilizes the following custom job fields on your job to intelligently source prospective candidates:

• Dice Easy Source
• Dice Easy Source: Required Skills & Keywords
• Employment Type
• Post To Dice (optional)

To enable these fields, click the Configure icon on your navigation bar, then click Custom Options on the left.

Click Jobs under the Company Custom Fields Section.

Click Add Field to create a new custom job field.

The following custom job fields will need to be configured in Greenhouse Recruiting:

Custom field 1: Dice Easy Source

Create a custom job field for Dice Easy Source. Enter the following to create the field:

• Field name: Dice Easy Source
• Description: Allows Dice Easy Source to automatically prospect the most relevant candidates from Dice.com directly to your Greenhouse Recruiting job.
• Field type: Yes / No

When finished, click Save.

Greenhouse Recruiting will generate an Immutable Field Key at the bottom of the page for the custom field. Copy the immutable field key to provide to your Dice Customer Success Manager in a later step.

Custom field 2: Dice Easy Source Required Skills & Keywords

Create a custom job field for Dice Easy Source Required Skills & Keywords. Enter the following to create the field:

• Field Name: Dice Easy Source: Required Skills & Keywords
• Description: A comma-separated list of required keywords for the Dice Easy Source. This filters out prospects 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

When finished, click Save.

Greenhouse Recruiting will generate an Immutable Field Key at the bottom of the page for the custom field. Copy the immutable field key to provide to your Dice Customer Success Manager in a later step.

Custom field 3: Employment Type (if applicable)

Your organization might already leverage a custom job field called Employment Type in Greenhouse Recruiting that designates the level of employment for your jobs, like full-time or part-time. Your Dice CSM can work with you to map these employment type field values to Dice's employment type filters. You must map your Greenhouse Recruiting employment type field values to Dice employment values and provide the following table to your Dice CSM.

You'll also need to provide the Immutable Field Key for your employment type field to your Dice CSM.

Custom field 4: Salary (if applicable)

Your organization might already leverage a custom job field called Salary in Greenhouse Recruiting that designates a max salary or salary range. If you'd like the Dice integration to filter out candidates based on a job's salary, provide the Immutable Field Key for this field to your Dice CSM.

Custom field 5: Post To Dice (optional)

Dice will automatically publish any externally posted job from your Greenhouse ATS. If you would like to have more control over what jobs are published to Dice, you can set up a custom field on the job for Dice to reference. This acts as a secondary filter to control which posted jobs should be added to Dice.

• Field name: Post To Dice
• Description: Controls whether the posted job is published on Dice. If set to No, the job will not be published or will be un-published from Dice.
• Field type: Yes / No

Greenhouse Recruiting will generate an Immutable Field Key at the bottom of the page for the custom field. Copy the immutable field key to provide to your Dice Customer Success Manager in a later step.

Create a custom source for the Dice integration

Prospect applications imported to Greenhouse Recruiting by the Dice integration will need to be attributed to a new custom source.

To create a new custom source, click the Configure icon on your navigation bar, then click Custom Options on the left.

Click Sources.

Click Create New Source, and enter the following details:

• Sourcing strategy: Prospecting
• Name of source: Dice Easy Source

Click Create source.

Enable the integration on Dice

Once you've set up the Harvest API keys and custom fields, you'll need to inform your Dice Custom Success Manager. Provide the following information to your Dice CSM:

• Harvest API Key: Please send in a secure manner to your CSM.
• "On-Behalf-Of" user id: The user ID that will be used for the Dice integration. You can create an integration system user (ISU) or use an existing Greenhouse Recruiting user's ID. (To find user IDs, click Configure > Users > then click Export to Excel to download the list of your Greenhouse Recruiting users and their IDs.)
• Dice Easy Source: Immutable field key created in previous step
• Dice Easy Source - Required Skills & Keywords: Immutable field key created in the previous step
• Employment Type: Immutable field key created in the previous step
• Salary: Immutable field key created in the previous step
• Post To Dice: Immutable field key created in the previous step
• Source Name: Custom source name created in the previous step

Additional integration configurations

You can enable the following additional integration configurations in Dice:

General Configurations

• Employment Type Mapping
  • Provide the corresponding Greenhouse employment types that map to Dice employment types
    • What Greenhouse employment type value(s) should Dice advertise as Full-time?
    • What Greenhouse employment type value(s) should Dice advertise as Part-time?
    • What Greenhouse employment type value(s) should Dice advertise as Contract?
      • Are there specific employment type values that we should align to the following?
        • Contract - 1099
        • Contract - W2
        • Contract - Corp to Corp (open to 3rd party applicants)
• Organization Name
  • Value: string
  • Why? Dice must know your Greenhouse customer id so that they can appropriately connect the integration to your Greenhouse instance.
  • Location in Greenhouse: To find the organization name, click the Configure icon > select Organization in the left navigation column > provide the Organization Name value.
• Remote Job Location Mapping
  • Value: list of string values
  • Why? You can provide specific location values that are used in the Greenhouse job post location. Dice will use these to determine whether your job is open to remote work.

Easy Post Specific Configurations:

• Default Job Posting Recruiter
  • Value: email address
  • Description: The fallback recruiter tied to the Dice published job when the selected recruiter in the Hiring Team is not a current Dice user.
• Apply Type
  • Value: offsite / onsite
  • Description: Dice can publish your jobs as an offsite redirect or as an onsite “Easy Apply” job.
• Job Board URL Id (if not using Easy Apply)
  • Value: string
  • Location in Greenhouse: Click the Configure icon > select Job Boards & Posts in the left column > click the ellipses icon > select Edit Board Settings > provide the value to the right of the boards.greenhouse.io/ URL
• Job Board Dice Tracking Link (if not using Easy Apply)
  • Value: string
  • Location in Greenhouse: Click the Configure icon > select Job Boards & Posts in the left column, click the ellipses icon next to your job board > select Tracking Link, click Select a source > select Dice from the Third Party Board section > click Create Link and copy the link

Easy Source Specific 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 Easy Source for Greenhouse integration
• Match score threshold:
  • Value: number - Provide a number between 1 - 5 to indicate the minimum level of match that a prospect must meet before being submitted to the job
    • 5 - Excellent Match
    • 4 - Great Match
    • 3 - Good Match
    • 2 - Fair Match
    • 1 - Poor Match

Create webhooks for the Dice integration

Next, create webhooks for the Dice integration. Dice requires four unique webhooks. Follow the steps in this article to create your webhooks. Use the values listed below to configure the webhook:

Webhook 1: Application updated

• Name: diceApplicationUpdated
• When: Application updated
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 2: Prospect rejected

• Name: diceProspectRejected
• When: Candidate or prospect rejected
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 3: Job post created

• Name: diceJobPostCreated
• When: Job Post Created
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 4: Job post updated

• Name: diceJobPostUpdated
• When: Job Post Updated
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 5: Job post deleted

• Name: diceJobPostDeleted
• When: Job Post Deleted
• Endpoint URL: The Endpoint URL provided by by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Webhook 6

• Name: diceJobUpdated
• When: Job Updated
• Endpoint URL: The Endpoint URL provided by your Dice CSM
• Secret Key: The Secret Key provided by your Dice CSM

Use the Dice integration with Greenhouse Recruiting

Easy Post Integration

Dice Easy Post for Greenhouse takes jobs from the Greenhouse open career portal and automatically advertises them to Dice technologists, streamlining your job advertising process on Dice. We allow you to flexibility configure which jobs are auto published based on Greenhouse job data.

Jobs are removed from our site once they expire or are removed from the client’s Greenhouse career portal. We prioritize the most recent postings and work within the client’s purchased jobs quotas from Dice.

Post a Job to Greenhouse Recruiting

Dice will read jobs posted to your Greenhouse career portal in 15-minute increments. Any new jobs posted will be picked up for processing. Any jobs that were unpublished from your Greenhouse career portal since the last process will also be captured so that they can be removed from Dice.

Jobs picked up for processing are then assessed for validity by the integration. The integration goes through the following checks prior to posting:

1. Is the Post to Dice field set to “Yes”?
   1. If not, the job is not posted to Dice
2. Is the job published to your external Greenhouse job board?
   1. If not, the job is not posted to Dice
3. Does the job id already exist in Dice?
   1. If so, Dice will update the existing job on our site
   2. If not, a new job is posted
4. Does the client have an available quota to post their job to Dice?
   1. If so, Dice will post/process the job
   2. If not, Dice will inactivate the oldest posted job from Dice, and post the new job

Integration Advertises Job on Dice

Valid jobs are posted as new or are updated on Dice. When posting, Dice will link the job’s publishing contact profile to the Dice job based on their Greenhouse email address. If the recruiter does not have a Dice recruiter profile, the job post will link to the configured default recruiter profile. We will send an email notification to the recruiter for any newly posted jobs on Dice. Dice job postings allow the client to map fields and field values from the Greenhouse job to their Dice posting so that the employment type and tax status is correctly reflected on Dice.

Unpublish Job from Greenhouse Recruiting

Any jobs that are unpublished from your Greenhouse job board will be removed from Dice. Furthermore, if you change the “Post to Dice” field value to “No”, the greenhouse job will be removed from Dice. Job postings that have not been updated or re-published within the Dice 30-day expiry period will be automatically unpublished by Dice. If an update is made to the job in Greenhouse the 30-day period is reset in Dice from the date of the update.

Recruiter Confirmation Email

When the recruiter’s job is posted on Dice, we provide them a simple email confirmation informing them that their job is now live on our site. The communication contains a simple link so that the recruiter can see how the job advertisement looks for technologists. Recruiters who have access to search and view talent in Dice’s Resume Database, will receive a link to a pre-populated saved talent search of candidates related to the job post.

Easy Source Integration

Once enabled, the Dice integration is simple to use. Set the Dice Easy Source custom job field to Yes on any open job (under Job Setup > Job Info) in Greenhouse Recruiting, and Dice will match and import relevant prospects to your job.

The integration uses the following job information to match prospects to your job:

Job post fields

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

Job custom fields

• Dice Easy Source - Required Skills & Keywords: List 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

Interacting with prospect results

Greenhouse Recruiting enables you to interact with prospects in a few different ways. You can search for prospects within the All Candidates search, see prospects from your job dashboard.

All candidates search

You can search for prospects by setting the Application Type filter on the Candidates page to Prospects only.

Backfill additional prospects

When a recruiter makes an action in Greenhouse Recruiting to 'Convert a prospect to a candidate' or 'Stop considering as prospect,' Dice will automatically search for the next most relevant prospect in the database and backfill them to the job.

Additional resources

For additional information or troubleshooting not covered here, reach out to dhipartnerships@dhigroupinc.com