Greenhouse

This page covers integrating Incode identity verification into the Greenhouse Applicant Tracking System (ATS). You can add verification steps directly to your hiring workflow to confirm candidate identity and reduce fraud.

Candidate Journey

The diagram below shows where identity verification fits into the recruiting workflow:

Key Stages

1. Application submission: Candidate applies through the job board.
2. eKYC check: Candidate's phone number and email trigger an Incode identity check. This is optional.
3. Risk scoring: Candidates are routed based on their eKYC risk score:
   • High risk: Immediate identity verification through document and selfie capture.
   • Medium risk: Verification before recruiter and hiring manager interviews.
   • Low risk: Direct progression to interviews.
4. Final verification: Candidate completes a final identity check before the offer or final interview.
5. Results sync: Results are written back into Greenhouse, updating the candidate profile.

Understand eKYC

eKYC (electronic Know Your Customer) is a digital identity verification process. It was developed for banking and compliance, but it applies equally to hiring.

For Greenhouse, eKYC:

• Uses candidate data, such as their email address and phone number, to perform fraud checks.
• Checks for history of fraud, synthetic activity, mismatched identity data, lack of history, and so on.
• Returns a risk score—low, medium, or high—to guide the level of additional verification needed.

Integration with Greenhouse Using Tines

This integration uses Tines, a powerful automation platform, to orchestrate the verification flow between Greenhouse and Incode. A prebuilt Tines story is available: Verify Candidate Identity with Greenhouse and Incode.

Example Flow

1. Trigger: A candidate submits an application in Greenhouse.
2. Action: Tines retrieves candidate data—name, email, and phone—through the Greenhouse API.
3. Verification: Tines sends the candidate an Incode verification link.
4. Callback: Incode returns verification results to Tines.
5. Update: Tines pushes the results back into Greenhouse, updating the candidate record.

Recruiters and hiring managers can see real-time verification status without leaving Greenhouse.

Set Up the Greenhouse Integration

Prerequisites

• A Greenhouse ATS account with API access
• An Incode developer account
• A Tines workspace for automation (or another automation platform)

Configure Greenhouse Webhooks and Custom Fields

Set up a webhook in Greenhouse to trigger when a candidate is created or changes stage. Go to your Greenhouse webhook settings and configure the following:

• Event: Candidate has been created or has changed stage.
• Payload: Candidate details, including name, email, and phone.
• Destination: Your Tines webhook URL.

Add custom fields in Greenhouse for the results you want to map, such as Verification Status and Risk Score. See Greenhouse: Add or edit a custom candidate field.

Build Tines Story

Import the Tines story and do the following:

• Update credentials for your Greenhouse and Incode APIs.
• Define routing rules based on eKYC risk scoring.
• Run the Lookup Customer Fields action to retrieve the results.

Connect to the Incode API

Use the Incode API to initiate and complete identity verification. The following endpoints are available:

• POST /omni/externalVerification/ekyc: Starts a risk check using email and phone.
• POST /v1/workforce/verification/candidate/generate-verification-link: Creates a URL for document and selfie verification.

Sync Results to Greenhouse

Tines calls the Greenhouse API to update candidate profiles with verification results.

Example Use Cases

• High-volume hiring: Automatically filter out fraudulent applications at scale.
• Sensitive roles: Enforce mandatory verification before final interviews.
• Global workforce compliance: Meet KYC/AML requirements in hiring.

What's Next

• Work with your Incode Solutions Engineer to get your Incode API credentials.
• Import the Tines story.
• Map your hiring journey to the verification checkpoints in the diagram.
• Deploy the automation in Tines and test with sample candidates.

Updated about 2 months ago