Integrating Greenhouse with imper.ai allows the platform to securely ingest candidate-related data and custom fields from your Greenhouse environment and use them as trusted inputs in verification workflows.
By leveraging Greenhouse as a source of truth for candidate information, imper.ai can validate identity context, enrich verification logic, and improve decision accuracy during helpdesk and security-sensitive interactions.
Only admin users can integrate Greenhouse with imper.ai.
Site admin with Developer Permissions with Manage ALL organization's API credentials permission.
Prerequisites
To integrate Greenhouse with imper.ai, you must:
Have admin permissions in Greenhouse.
Be able to create and manage Harvest V3 (OAuth) API credentials.
Know how to define and limit API scopes in Greenhouse.
Create Greenhouse API Credentials
imper.ai integrates with Greenhouse using Harvest V3 (OAuth) credentials.
Log in to your Greenhouse account.
Navigate to Configure > Dev Center > API Credentials.
Click Create new API credentials.
From the API type dropdown, select Harvest V3 (OAuth).
Assign the required scopes listed below.
Click Create.
After creation, Greenhouse generates two credentials:
Client Key
Client Secret
Copy and store the Client Secret securely. If it is lost, the credentials must be rotated.
Required API Scopes
The following Greenhouse scopes are required for the integration to function correctly:
Applications
List applications
Candidates
List candidates
Update candidates
Custom Fields
Create custom fields
List custom fields
Update custom fields
Email Templates
List email templates
Interviews
List Interviews
Interviewers
List interviewers
Job Interviews
List job interviews
Jobs
List jobs
Notes
Create notes
List notes
Sources
List sources
Users
List users
These permissions allow imper.ai to retrieve candidate data and manage custom attributes used during verification workflows, as well as enable meeting protection and alerts through interview notes.
Connect Greenhouse in imper.ai
Once your Greenhouse API credentials are ready:
Log in to the imper.ai Admin Console.
Navigate to Integrations.
Locate Greenhouse and click Connect.
In the connection modal:
Client Key
Client Secret
IMPORTANT: Confirm the required scope configuration before clicking Connect
Click Connect.
imper.ai integrations page
Greenhouse integration page
Protected Users Configuration (TA/HR Users)
To ensure that interview links are wrapped with imper.ai’s secure link, all relevant users must be added as Protected Users in imper.ai.
Protected Users are internal, trusted participants whose presence enables imper.ai to automatically wrap meeting links and enforce verification for external participants (candidates).
Steps for Admins:
Navigate to settings -> protected users in the imper.ai console.
Add the user who requires protection.
Without this configuration, interview links may not be wrapped correctly, and verification may not be triggered for candidates.
Add HR user to protected users list
Accessing the Interviews Page
To allow HR users to view the Interviews page in the imper.ai console, an administrator must assign the HR role to the user in User Management.
Steps for Admins:
Navigate to settings -> User Management in the imper.ai console.
Add the user who requires access.
Assign the HR role to the user.
Invite user.
Add HR user in user management
Once the HR role is assigned, the user will have full access to The Interviews page.
Users without the HR role will not be able to access the Interviews page.
Candidate Email Template Configuration
When an interview is created in Greenhouse, candidates receive an email invitation by default. The default template and all other candidate templates, can contain the original meeting link, which are not wrapped with imper.ai’s secure link.
To ensure that candidates always join the meeting via the secure, wrapped link:
In Greenhouse, go to Options → Email Templates, then edit each candidate email template, including the default Candidate Interview Confirmation Message
remove {{interview schedule}}
Save the changes.
Options -> Email Templates
Edit Options -> Email Templates
This change will also remove the interviewer name
After this change, candidates will join the interview via their calendar event, where imper.ai automatically wraps the meeting link. This ensures that verification is triggered and the interview is fully protected.
Validation Behavior
During connection, imper.ai performs the following validations:
Credential Validation
Verifies that the provided Client Key and Client Secret are valid and can authenticate with Greenhouse.
If validation fails, a Failed error is displayed.
Scope Validation
Verifies that all required scopes are enabled on the Greenhouse credentials.
If one or more required scopes are missing, the connection will fail and the integration will not be completed.
Integration Status
Once successfully connected:
Greenhouse appears under My Integrations.
The integration status is shown as Connected.
imper.ai can begin securely accessing candidate data and custom fields as part of verification workflows.
Summary
The Greenhouse integration enables imper.ai to use candidate-level data as a trusted contextual source during identity verification. By integrating via Harvest V3 (OAuth) and enforcing strict scope validation, organizations ensure secure, auditable access while improving verification accuracy.