1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Optimization

Endorsed integration

Endorsed is your AI resume screening assistant that enables you to find better applicants that you may have missed, reduce human error and bias, and save up to three hours for every 100 applicants you receive.

Greenhouse Recruiting’s best-in-class integration with Endorsed enables users to:

  • Configure industry-leading AI to screen candidates based on your unique criteria
  • Score and rank candidates based on your unique criteria
  • Create AI-powered knockout questions
  • Intelligently bulk reject candidates not meeting baseline criteria
  • Automatically change the stages of candidate in Greenhouse when candidates are advanced or rejected in Endorsed
  • Trigger automated emails in Greenhouse when candidates are advanced or rejected in Endorsed
  • Sync jobs and applicants from Greenhouse to Endorsed

In this article

Create a Harvest API key for the Endorsed integration

To configure the Endorsed integration, you’ll need to create a Harvest API key. 

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

Credentials

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

  • API Type: Harvest
  • Partner: Endorsed or Unlisted Vendor
  • Description: Endorsed Harvest API Key

Permissions

Verify the following permissions are selected for your API key:

  • Activity Feed
    • GET: Retrieve Activity Feed
  • Applications
    • GET: Retrieve Application
    • GET: List Applications
    • PATCH: Update Application
    • PATCH: Convert a prospect
    • PATCH: Update a rejected application’s rejection reason
    • POST: Advance Application
    • POST: Hire Application
    • POST: Move Application
    • POST: Reject Application
    • POST: Moves Application to Job
    • POST: Unreject Application
  • Candidate Attribute Types
    • GET: List Candidate Attribute Types
  • Candidates
    • GET: Retrieve Candidate
    • GET: List Candidates
    • POST: Add Note
  • Close Reasons
    • GET: Get close reasons
  • Custom Field Options
    • GET: Custom Field Options
  • Custom Field
    • GET: Get custom fields
  • Custom Locations
    • GET: Retrieve Custom Location for Job Board
  • Departments
    • GET: Retrieve Department
    • GET: List Departments
  • Education
    • GET: Get degrees
    • GET: Get disciplines
    • GET: Get schools
  • EEOC
    • GET: Retrieve EEOC Data for Application
    • GET: List EEOC
  • Email Templates
    • GET: Retrieve Email Template
    • GET: List Email Templates
  • Interview Kits
    • GET: List Interview Kits
  • Job Openings
    • GET: List Openings for a job
  • Job Posts
    • GET: List Job Posts
    • GET: Retrieve Job Post for Job
    • GET: List Job Posts for Job
  • Job Stages
    • GET: Retrieve job stage
    • GET: List job stages
    • GET: List job stages for job
  • Jobs
    • GET: Retrieve job
    • GET: List jobs
  • Offers
    • GET: List application's offers
    • GET: Retrieve application's current offer
    • GET: Retrieve offer
    • GET: List offers
  • Offices
    • GET: Retrieve office
    • GET: List offices
  • Rejection Reasons
    • GET: List rejection reasons
  • Scheduled Interviews
    • GET: List interviews for application
    • GET: Retrieve interview
    • GET: List interviews
  • Scorecard Question Options
    • GET: List Scorecard Question Options
  • Scorecards
    • GET: Retrieve application's scorecard
    • GET: List Focus Candidate Attributes
    • GET: List Job Candidate Attributes
    • GET: List Scorecard Candidate Attribute Ratings
    • GET: List Scorecard Candidate Attributes
    • GET: List Scorecard Question Answers
    • GET: List Scorecard Question Candidate Attributes
    • GET: List Scorecard Questions
    • GET: List Scorecards
  • Sources
    • GET: List sources
  • Tags
    • DELETE: Remove tag from candidate
    • GET: List tags applied to candidate
    • GET: List candidate tags
    • PUT: Add a candidate tag
  • User Roles
    • GET: List User Roles
  • Users
    • GET: Retrieve User
    • GET: List Users
    • GET: List Pending Approvals
    • GET: List User Job Permissions
    • GET: List User Future Job Permissions

Copy the Harvest API key to provide to Endorsed in the next step. 

Finish configuration in Endorsed

After your API key is created, follow the instructions on Endorsed Help Center to complete your connection to Endorsed.

Use the Endorsed integration with Greenhouse Recruiting

Once the integration is connected, Endorsed will sync actions taken in Endorsed to Greenhouse Recruiting. For example, when a user rejects a candidate on Endorsed, this action will be synced to Greenhouse with the credited user being the same user who took the action.

When you advance or reject candidates in Endorsed, these actions are automatically and immediately synced to Greenhouse.

The Advancing button in Endorsed will move the candidate to a specified stage, which is set up as a mandatory step for each job within Endorsed. Additionally, any automated emails configured in Greenhouse to send when candidates are advanced or rejected will also be triggered by these actions in Endorsed.

Sync jobs to Greenhouse Recruiting

To start using Endorsed with your Greenhouse ATS, you can take the following steps.

Sign up and create an Endorsed account, or log into your existing account. 

Choose Recruiting as your Organization Type.

Click Connect ATS Account button. Occasionally, this button will take a few seconds to load.

Find Greenhouse in the ATS integration window. Select the Greenhouse integration. Do not select the Greenhouse - Job Boards API option, as that's used for a different setup. 

Click Continue to give Endorsed access to your Greenhouse account.

Paste in your Harvest API key and click Submit. 

Wait for the API connection to complete. This can take up to a minute.

Note: If your account is not able to connect to Greenhouse, contact Endorsed Support by clicking the button in the button right corner of your screen to start a live chat. 

When the connection is complete, you'll automatically be redirected to your Jobs page. After your first setup, Endorsed will need to sync with Greenhouse Recruiting to load the initial data. The time needed for this initial sync can differ for different customers, based on the number of jobs and candidates in your system.

If this sync takes longer than 24 hours, contact Endorsed support.

When the job sync is complete, your integration set up is complete.

Additional resources

For any questions or further troubleshooting support, reach out to the Endorsed team atsupport@endorsed.com.