Skip to main content
Integrating Greenhouse
Updated over a week ago

In order to integrate Greenhouse with candidate.fyi, you need to create a new API key in Greenhouse.

*Note - you must be an admin in Greenhouse to do this

  1. Head over to "configure" (in the top right)

2. Select "Dev Center"

3. Select API Credentials

4. Create new API key

5. Create new credential

  • For type, select "Harvest".

  • For Partner select "candidate.fyi".

  • For Description enter "candidate.fyi API Key"

6. Select Manage Permissions and enter the following:

For Candidate Portal:

  • Applications

    • Get: Retrieve Application

    • Get: List Applications

  • Candidates

    • Get: Retrieve Candidate

    • Get: List Candidates

  • Tags

    • Get: List tags applied to candidate

    • Get: List Candidate Tags

  • Users

    • Get: Retrieve User

    • Get: List Users

    • Get: List User Job Permissions

  • Offers

    • Get: List Application's Offers

    • Get: Retrieve Application's Current Offer

    • Get: Retrieve Offer

    • Get: List Offers

  • Scheduled Interviews

    • Get: List Interviews for Application

    • Get: Retrieve Interview

    • Get: List Interviews

  • Departments

    • Get: Retrieve Department

    • Get: List Departments

  • Jobs

    • Get: Retrieve Job

    • Get: List Jobs

    • Get: Get hiring team

  • 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

  • Job Openings

    • Get: List Openings For a Job

  • Offices

    • Get: Retrieve Office

    • Get: List Offices

  • Rejection Reasons

    • Get: List Rejection Reasons

  • Sources

    • Get: List Sources

  • User Roles

    • Get: List User Roles

  • Close Reasons

    • Get: Get close reasons

For ATS Booking Links And/Or Scheduling, we also need (in addition to the above)

  • Candidates

    • Post: Add Note

    • Post: Add Application

    • Post: Add Candidate

    • Post: Add E-mail

    • Patch: Edit Candidate

    • Put: Merge two candidates

    • Post: Add Attachment

    • Post: Add Prospect

  • Applications

    • Patch: Update Application

    • Post: Unreject Application

    • Patch: Convert a prospect

    • Post: Advance Application

    • Post: Add Attachment to Application

    • Post: Moves Application to Job

    • Post: Move Application

    • Patch: Update a rejected application's rejection reason

  • Scheduled Interviews

    • Post: Create a scheduled interview

    • Patch: Update a scheduled interview

    • Delete: Delete a scheduled interview

Did this answer your question?