Greenhouse

This guide will help you to connect to greenhouse account via Knit

Generating Greenhouse API key:

  1. Login as administrator and click on the settings icon on upper left corner of your page.
  1. Click on Dev Center in the left menu.
  1. Select API Credential Management and click on the Create New API Key
  1. Select Harvest for the API Type. Enter a description for the API key and click Manage Permissions.
  1. Click the Copy button, and paste the API key below. Next, click I have stored the API key.
  1. Either click Select All or select the relevant permissions required as per your need. See the below permissions list for Knit data models.
  1. Once permissions are enabled. This API Key is good to used with Knit in Authenticating with Greenhouse.

Managing Permissions

If you plan to enable only fewer permissions for the use cases you will be using through knit, below is the context of permissions that are used by the respective Knit Use Case.

  1. Users - Get: List Users is a Required scope for doing a successful Integration.
  2. ats_jobs sync :
    1. Job Stages - Get: List Job Stages for Job
    2. Jobs - Get: Retrieve Job, Get: List Jobs, Get: Hiring Team
    3. Job Posts - Get: List Job Posts for Job
    4. Users - Get: Retrieve User
  3. ats_applications sync:
    1. Applications - Get: List Applications, Get: Retrieve Application
    2. Candidates - Get: Retrieve Candidate
    3. Sources - Get: List Sources
    4. Scheduled Interviews - Get: List Interviews for Application
    5. Offers - List Application's Offers
    6. Users - Get: Retrieve User
  4. ats_candidates sync
    1. Candidates - Get: List Candidates, Get: Retrieve Candidate
  5. Similarly for other APIs add the relevant permissions that suits for the use case your are trying.
  6. For Example: If you want use list eeoc or get eeoc apis via Knit then enable, EEOC - Get: Retrieve EEOC Data for Application and Get: List EEOC in permissions for your API Key.