imper.ai

Appearance

Connecting Greenhouse

Connect your Greenhouse account so imper.ai can securely ingest candidate-related data and custom fields to use as trusted inputs in verification workflows.

This article explains how to connect Greenhouse to imper.ai and verify a successful connection.

NOTE

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 API credentials in Greenhouse.

  • Know how to define and limit API scopes in Greenhouse.

Create Greenhouse API Credentials ​

imper.ai integrates with Greenhouse using Harvest V3 (OAuth) credentials.

  1. Log in to your Greenhouse account.

  2. Navigate to Configure > Dev Center > API Credentials.

  3. Click Create new API credentials.

  4. From the API type dropdown, select Harvest V3 (OAuth).

  5. Assign the required scopes - see Greenhouse Permissions.

  6. Click Create.

After creation, Greenhouse generates two credentials :

  • Client Key

  • Client Secret

NOTE

Copy and store the Client Secret securely. If it is lost, the credentials must be rotated.

Connect Greenhouse in imper.ai ​

Once your Greenhouse API credentials are ready:

  1. Log in to the imper.ai Admin Console.

  2. Navigate to Integrations.

  3. Locate Greenhouse and click Connect.

  4. In the connection modal:

    1. Client Key

    2. Client Secret

  5. IMPORTANT: Confirm the required scope configuration before clicking Connect

  6. Click Connect.

imper.ai integrations page

Greenhouse integration page

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.

What's Next ​

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.

Copyright © Imper AI