Permissions: Job Admin or higher

Product tier: Available to all subscription tiers

RepVue is a career influencer platform where sales pros discover, research, and apply for roles at the world's most well known sales orgs. Sales pros gain access to RepVue by submitting an objective rating of an org where they’ve worked. RepVue leverages this dataset to drive attraction and retention of talent for b2b sales orgs via talent competitor and comp benchmarking as well as premium site promotional opportunities, acting as a source of candidates for the world’s most well known sales brands.

Greenhouse Recruiting's integration with RepVue allows a seamless recruiting experience for employers. Recruiters will be able to leverage their existing workflows to engage candidates, seamlessly push jobs into the RepVue system, update the status of those jobs, and access RepVue candidates via Greenhouse Recruiting.

In this article, we will cover:

Configure user setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / RepVue 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 Configured_Icon.png > 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 Recruiting / RepVue integration

To create a Harvest API key for the integration, click on the Configure icon Configured_Icon.png 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 RepVue.

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

  • API Type: Harvest
  • Partner: RepVue
  • Description: RepVue Harvest API Key

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

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 RepVue 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.

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

On the Manage API Key Permissions page, please select all boxes available. When finished, click Update.

All_API_Permissions.png

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 Recruiting / RepVue integration is created and configured.

Provide your Harvest API key to your RepVue onboarding team so they can finish setting up the integration.

Use the Greenhouse Recruiting / RepVue integration

There are four integration points for the Greenhouse Recruiting / RepVue integration: accessing jobs, creating candidates, updating candidates, and updating jobs.

Accessing jobs

RepVue pulls 'job posts' from Greenhouse Recruiting into RepVue via the Harvest API endpoint GET: List Job posts, and ingests the following fields from your job posts:

  • ID (the job post ID)
  • Title (the job post title)
  • Content (the content of the job post, or job description)
  • Location name (the location of the Greenhouse Recruiting job)
  • Job ID (the ID of the job)

RepVue only pulls in job posts one time, and each job post will create a 'job' in the RepVue system with a default status of new. RepVue looks for new job posts once per hour via this API call.

Creating candidates

RepVue leverages the Harvest API endpoint POST: Add candidates to create candidates in Greenhouse Recruiting when an applicant clicks Apply via RepVue for a job that has been posted for a Greenhouse Recruiting <> RepVue integration user. 

RepVue provides the following candidate fields to Greenhouse Recruiting:

  • First Name
  • Last Name
  • E-mail address ('Other' is used for email type)
  • LinkedIn URL
  • Job ID
  • Source

When RepVue creates candidates in Greenhouse, RepVue receives a response with the following information:

  • Candidate ID
  • Application ID

Note: When an applicant clicks Applies via RepVue, the candidate profile is created in Greenhouse Recruiting within about 15 minutes.

Updating candidate status

When a candidate is successfully created in Greenhouse Recruiting, the candidate status will default to ‘engagement’ status in the RepVue system. RepVue checks candidate status regularly to track rejections and hires via the Greenhouse Recruiting / RepVue integration via the Harvest API endpoint GET: List candidates.

RepVue provides the Greenhouse Recruiting candidate ID along with the Greenhouse Recruiting application ID(s), and receives back the following information:

  • Status (application status)
  • Stage name (‘current stage’ in Greenhouse Recruiting)

For the ‘Status’ field there are three potential responses from Greenhouse Recruiting:

  • Rejected: For any application with a Greenhouse Recruiting status of rejected, RepVue sets the RepVue connection status to declined.
  • Active: For any application with a Greenhouse Recruiting status of active, RepVue sets the RepVue connection status to engaged.

Note: For new connections created via RepVue, the status will default to ‘active’ when created. The expected behavior is that the application status of 'active' will trigger an update in the RepVue system for the connection status to change from ‘new’ to ‘engagement’ in the RepVue system until it is subsequently set to 'rejected' or 'hired.'

  • Hired: For any application with a Greenhouse Recruiting status of hired, RepVue sets the RepVue connection status to hire successful.

RepVue checks hourly for status updates to candidates.

Updating job post status

Job posts that are turned off in Greenhouse Recruiting are also removed from RepVue. RepVue checks the job post status regularly via the Harvest API endpoint GET: Retrieve job posts

RepVue checks all jobs in RepVue with a status of ‘active’ or ‘new’ in Greenhouse Recruiting system via the API for the job post status, leveraging the job posts call in the Harvest API endpoint GET: Retrieve job posts

  • If the LIVE status is FALSE for a job post on Greenhouse Recruiting, the RepVue job status will be set to ‘archived,' which automatically pulls the job off of the RepVue job board.
  • If the LIVE status is TRUE for a job post on Greenhouse Recruiting, no action is taken.

RepVue checks hourly for status updates to job posts.

Additional resources

For additional information not covered here, reach out to your designated RepVue account representative or email info@repvue.com.