Greenhouse Integration

What It Does

Aperture conducts a structured, conversational AI interview with each candidate, scores the transcript against the skills a role actually requires, and ranks every candidate against the rest of the applicant pool for that job, so recruiters get a consistent, comparable signal instead of a pile of unstructured screens.

Aperture's integration with Greenhouse Recruiting lets you add the Aperture AI interview to a job's interview plan, send it to candidates without leaving Greenhouse, and receive each candidate's score, pool rank, and a link to their full report directly on their Greenhouse profile.

Before You Begin

• Site Admin permissions in Greenhouse Recruiting, with permission to authorize third-party integrations.
• An Aperture account with Admin permissions.
• Aperture enabled for your organization.

Enable the Integration

Setting up Aperture with Greenhouse Recruiting has three parts: authorize Aperture from your Aperture account, provide your Aperture API key to Greenhouse Support, then add the Aperture stage to a job's interview plan. The second step involves a ticket with Greenhouse Technical Support, so allow time for their reply before you plan to send your first assessment.

Step 1: Connect Greenhouse from Aperture

1. In Aperture, go to Settings → Integrations.
2. On the Greenhouse card, click Connect.
3. You're redirected to Greenhouse to authorize the connection. Review the permissions Aperture requests and click Authorize.
4. After authorizing, you're returned to Aperture. The Greenhouse connection shows as Active, and an initial sync begins automatically, importing your jobs, departments, offices, and users.

Aperture connects using OAuth 2.0 (authorization code flow). Aperture never asks for, and never stores, your Greenhouse user password.

Step 2: Provide Your Aperture API Key to Greenhouse Support

Your Aperture API key is what tells Greenhouse Recruiting which Aperture account to send candidates to. Greenhouse Technical Support adds it to your account for you.

1. In Aperture, on the Greenhouse connection, click the reveal icon next to Aperture API Key, then click Copy. You don't need to request a key from Aperture, your account generates its own.

2. Follow the steps in Greenhouse Support's guide to setting up an assessment API integration to provide your Aperture API key to Greenhouse Technical Support and add the assessment stage to your interview plans.

   Keep your API key out of plain text

   Do not send your API key in any unencrypted communication, such as email or the body of a support ticket. Greenhouse Technical Support will provide a SendSafely link for you to enter it securely.

3. Wait for the confirmation email from Greenhouse Technical Support. Once confirmed, Aperture is enabled on your Greenhouse account.

Step 3: Add the Aperture Stage to an Interview Plan

1. In Greenhouse Recruiting, navigate to the job you want to use Aperture on.
2. Click Job Setup → Interview Plan.
3. Click + Add a Stage, then choose the Aperture take-home test stage.
4. Save the interview plan. Repeat for any other job that should use the Aperture AI interview.

Using the Integration

Once Aperture is enabled and added to a job's interview plan, your team works entirely from Greenhouse Recruiting.

Send the Interview to a Candidate

1. Open the candidate's profile in Greenhouse Recruiting.
2. Move the candidate to the Aperture stage.
3. Click Send Test next to the Aperture stage.

Aperture emails the candidate their interview invitation. The invitation and any reminders are sent by Aperture.

Track the Interview's Status

After the interview has been sent, its status is shown on the candidate's profile in Greenhouse Recruiting. The status updates automatically as the candidate progresses.

Review the Results

When the candidate completes their AI interview, Aperture scores it and writes the results back to Greenhouse Recruiting in three places:

1. The take-home test result: the candidate's Aperture score, shown on the Aperture stage.
2. The Aperture Rank field: the candidate's position within the pool of everyone assessed for that job, e.g. 3 of 8. This stays current: as more candidates complete their interviews, Aperture updates the rank of everyone already assessed for that job.
3. A note on the candidate's Activity Feed: a one-line summary of rank and score, e.g. Aperture: Ranked #3 of 8 -- Score: 91 / 100.

Once the candidate has submitted their interview, the Interview Kit contains a link to view the completed assessment in Aperture. Click View Report to see the candidate's full results: the per-skill breakdown, the interview transcript, and how the candidate compares to the rest of the pool for that job.

Withdrawing a Candidate

If a candidate is rejected or withdrawn in Greenhouse Recruiting before completing their interview, Aperture cancels the pending interview automatically. No action is needed in Aperture.

Understanding the Integration

This section describes what Aperture adds to your Greenhouse account and what data it reads and writes. No action is required, it's here so you know what to expect.

The Aperture Rank Custom Field

Aperture keeps each candidate's position within the applicant pool up to date on their Greenhouse application using a custom application field. You do not need to create this field manually. The first time Aperture writes a rank for your organization, it creates the field automatically with these settings:

If a field named Aperture Rank already exists on your account, Aperture reuses it rather than creating a duplicate. You can view it under Configure → Custom Options → Application.

What Aperture Reads and Writes in Your Greenhouse Account

Aperture requests only the permissions it needs to run and return assessments.

Aperture reads the following:

Aperture writes the following:

Aperture does not modify candidate profiles, move candidates between stages, reject candidates, or change any other Greenhouse data.

Field Mapping

Frequently Asked Questions

Does Aperture move candidates between stages in Greenhouse?

No. Aperture writes results back to the candidate's profile but never advances, rejects, or otherwise moves a candidate. Your team keeps full control of the pipeline.

What happens if a candidate doesn't complete their interview?

The stage stays in its pending state and no score or rank is written. You can resend the test from Greenhouse Recruiting.

Why does a candidate's Aperture Rank change after it was first written?

Rank is relative to everyone assessed for that job. When a new candidate completes their Aperture interview, the ranks of everyone already assessed are recalculated and updated in Greenhouse, so the field is never stale.

Can I use Aperture on more than one job?

Yes. Add the Aperture stage to each job's interview plan. Ranking is calculated per job, so candidates are only ever compared against others assessed for the same role.

Who is the user shown on Aperture's notes?

Greenhouse's automatically generated Integration System User for Aperture. Notes are attributed to the integration rather than to an individual teammate.