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
In Scytale, go to 'Integrations'.
Search for Greenhouse and select 'Connect'.
Paste the API key you generated in Greenhouse (see steps below).
Add a connection name – this will be used to differentiate between your connections – and then select 'Next'.
Click 'Submit' to complete the connection.
You have now successfully connected to Greenhouse!
How to Generate an API Key in Greenhouse
Log in to your Greenhouse account:
https://subdomain.greenhouse.ioClick the Settings icon (top-right corner).
Navigate to Dev Center in the left panel.
Click API Credential Management.
Click 'Create New API Key'.
• API type: Select Harvest
• Partner: Leave blank
• Description: Give your key a meaningful nameClick 'Manage Permissions'.
Copy the API key and store it securely — you will be redirected to the Manage Permissions page.
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.

