HR Tools
      Back to home
      1. Help Center
      2. Integrations
      3. HR Tools

      Greenhouse - User Guide

      In this article, you will understand step by step how to easily integrate with Greenhouse

      Integrating with Greenhouse will allow Scytale to collect all the job descriptions of the hiring process. Job requirements are documented in the job descriptions and are an important part of the hiring process. This is one of the key criteria when testing the Control Environment trust service principle.

      Automating the collection of job descriptions will streamline the audit's sampling process and provide more assurance over the accuracy and completeness of the evidence collected. By using this integration, human intervention is eliminated, which gives more assurance to the auditors that the evidence can be relied on.

       

      How to Connect Scytale and Greenhouse

      1. In Scytale, go to 'Integrations'.

      2. Search for Greenhouse and select 'Connect'.

      3. Paste the API key you generated in Greenhouse (see steps below).

      4. Add a connection name – this will be used to differentiate between your connections – and then select 'Next'.

      5. Click 'Submit' to complete the connection.

      You have now successfully connected to Greenhouse!

       

      How to Generate an API Key in Greenhouse

      1. Log in to your Greenhouse account: https://subdomain.greenhouse.io

      2. Click the Settings icon (top-right corner).

      3. Navigate to Dev Center in the left panel.

      4. Click API Credential Management.

      5. Click 'Create New API Key'.
            • API type: Select Harvest
            • Partner: Leave blank
            • Description: Give your key a meaningful name

      6. Click 'Manage Permissions'.

      7. Copy the API key and store it securely — you will be redirected to the Manage Permissions page.

      8. Select all required permissions as outlined below.

      Permissions for Greenhouse Integration

      Scytale uses read-only access via a Harvest API key to collect job descriptions and related evidence. Only the permissions necessary for audit purposes should be granted:

      Applications

      • Get: Retrieve Application

      • Get: List Applications

      Candidates

      • Get: Retrieve Candidate

      • Get: List Candidates

      Offers

      • Get: List Application's Offers

      • Get: Retrieve Application's Current Offer

      • Get: Retrieve Offer

      • Get: List Offers

      Jobs

      • Get: Retrieve Job

      • Get: List Jobs

      • Get: Get the 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

      • Get: Get the hiring team

       

      📌 Scytale limits permission scopes strictly to what’s required to collect reliable audit evidence.