Greenhouse Integration

Start your free trial

Book a call to get your Nova account set up.

Nova reviews every inbound applicant against the requirements of the role, searches the candidate records you already have for people worth revisiting, and returns a score with the evidence behind it. Nova finds, reads, and ranks. The recruiter decides. Nova’s integration with Greenhouse Recruiting syncs your jobs and applications into Nova, screens applicants automatically as they apply, and writes Nova’s score, labels, and assessment back onto the Greenhouse application, so recruiters can review and filter results without leaving Greenhouse.

How Nova works in Greenhouse

Before you start

A Nova account. If your organization does not have one, contact nova@dweet.com.
A Greenhouse Recruiting user with the Site Admin permission level. Greenhouse requires Site Admin to authorize a Harvest integration.
We recommend authorizing with a service account so the connection belongs to your organization rather than to one person. A connection owned by an individual stops working when that person is deactivated.

Connect Greenhouse

Open ATS settings in Nova

Go to Settings, select ATS Integration, then select Connect ATS and choose Greenhouse.

ATS Integration settings in Nova with the Connect ATS button

Authorize in Greenhouse

Nova sends you to Greenhouse’s consent screen, which lists the permissions Nova requests. Choose to authorize using a service account, then confirm.

Return to Nova

You land back in Nova with the integration active. Nova starts syncing your jobs and applications, and scores new applicants as they arrive.

What Nova creates on connection

Nova provisions two custom application fields in your Greenhouse account, if they do not already exist:

Nova Score: a number field holding the score Nova gives an application, from 1 to 10.
Nova Tags: a multi-select field used for optional job-specific score labels.

You can see them in Greenhouse under Configure, Custom Options, Custom Fields, Application. No manual setup is required.

Nova Score and Nova Tags application fields in Greenhouse custom options

Permissions Nova requests

The consent screen groups the permissions Nova requests. Each group maps to a part of the integration. The exact scope names are in the permission reference below.

Permission group	What Nova uses it for
Read jobs, job posts, and interview stages	Know which roles are open, what each role requires, and which stages exist, so Nova can match its work to your pipeline
Read applications, candidates, and attachments	Read the application, the candidate record, and the resume in order to screen the applicant
Read departments, offices, sources, referrers, users, rejection reasons, and rejection details	Reference data Nova shows alongside a candidate, and the reason a past applicant was rejected, so Nova does not resurface someone already declined for that reason
Read and write application custom fields and their options	Create and maintain the Nova Score and Nova Tags fields, and write results into them
Read and write candidate tags	Apply Nova’s own labels to a candidate, for example a score band
Read and create notes	Post Nova’s assessment on the candidate
Move applications between stages	Advance an application, only when a recruiter confirms the action in Nova
Create candidates and applications	Add a candidate a recruiter sourced in Nova into a Greenhouse job, only when the recruiter chooses to
Manage webhooks	Register and maintain Nova’s own event subscriptions so updates reach Nova promptly. Nova only manages webhooks it creates.

What Nova writes to Greenhouse

Nova writes only what is listed here. Nova does not edit the rest of a candidate or application record.

Field or record in Greenhouse	Action Nova takes	When it happens
Nova Score custom application field	Writes a number from 1 to 10	Each time Nova scores an application
Nova Tags custom application field	Adds a label such as `REQ-123 - 8/10`	Each time Nova scores an application, if job-specific score labels are enabled
Candidate tags	Creates and applies Nova-named tags, for example a score band	Each time Nova scores an application
Note on the candidate	Creates a note containing Nova’s assessment	Each time Nova scores an application
Application stage	Moves the application to another stage	Only when a recruiter confirms the action in Nova
Candidate and application	Creates a new candidate and application on the job	Only when a recruiter adds a sourced candidate to Greenhouse from Nova

Nova does not delete candidates, applications, jobs, or any field it did not create. Nova skips scoring for candidates who have already been rejected.

Screen inbound applicants

This runs by default once the integration is connected and you enable screening on a job. No recruiter action is needed to keep it running.

A candidate applies to one of your Greenhouse jobs.
Nova syncs the application, reads the resume and the application question answers, and assesses the candidate against the requirements of that role.
Nova writes the result back to Greenhouse: the score into the Nova Score field, its assessment as a note on the candidate, and its labels as candidate tags.

Nova job list showing screening active on a Greenhouse job

In Greenhouse, the score appears on the candidate and the assessment appears in the notes panel, with the evidence behind each point.

Nova Score and Nova assessment note on a candidate in Greenhouse

In Nova you see the same score together with its evidence, so you can check the reasoning rather than trusting a number.

Filter candidates in Greenhouse by score

Because Nova writes the score into a Greenhouse custom field, you can filter on it from the Greenhouse Candidates page without opening Nova. Filtering on Nova Score alone returns candidates who received that score for any job they applied to. To filter by requisition and score together, enable job-specific score labels. Nova then adds a label such as REQ-123 - 8/10 to the Nova Tags field, and filtering on that label finds the candidates who scored 8 for REQ-123. Anyone who can manage company settings can turn this on in Nova, under Settings, ATS Integration, Job-specific score labels. When Nova scores an application again, it adds the new label alongside the previous one. You can clear Nova’s labels from Nova at any time.

Other things Nova can do with your Greenhouse data

Search the candidates already in your Greenhouse. Recruiters can search the candidate records already in your account to find people worth revisiting for an open role, instead of starting every search from scratch. Contact nova@dweet.com to enable this for your account. Add a sourced candidate to Greenhouse. When a recruiter finds a candidate in Nova who is not yet in your Greenhouse account, they can add that candidate to a Greenhouse job from Nova. Nova creates the candidate and their application on the job the recruiter chooses, and only when the recruiter chooses to. Contact nova@dweet.com to enable this for your account.

If the connection stops working

Nova shows a reconnect prompt in its Greenhouse integration settings. Select it to re-authorize with Greenhouse. If the problem continues, contact nova@dweet.com.

Permission reference

The exact permissions Nova requests on the Greenhouse consent screen. Nova requests no permission outside this list.

Read permissions

Permission	Purpose
`harvest:jobs:list`	Read open jobs so Nova screens against the right role
`harvest:job_posts:list`	Read the job description used as scoring context
`harvest:job_interview_stages:list`	Map Nova’s actions to the stages configured on a job
`harvest:application_stages:list`	Read which stage an application currently sits in
`harvest:applications:list`	Sync applications for screening
`harvest:candidates:list`	Read the candidate record attached to an application
`harvest:attachments:list`	Read the resume attached to an application, in order to screen the applicant
`harvest:notes:list`	Read recruiter notes for context, and avoid posting a duplicate assessment
`harvest:custom_fields:list`	Find existing custom fields so Nova does not create duplicates
`harvest:custom_field_options:list`	Read the options on the Nova Tags field
`harvest:candidate_tags:list`	Read the tags available in your account
`harvest:applied_candidate_tags:list`	Read which tags are already applied to a candidate
`harvest:users:list`	Confirm the account Nova is connected as is active
`harvest:departments:list`	Reference data Nova shows alongside a candidate
`harvest:offices:list`	Reference data Nova shows alongside a candidate
`harvest:sources:list`	Report on where candidates came from
`harvest:referrers:list`	Report on referral origin
`harvest:rejection_reasons:list`	Read why a past applicant was rejected
`harvest:rejection_details:list`	Read the detail behind a rejection, so Nova does not resurface someone already declined for that reason

Write permissions

Permission	Purpose
`harvest:custom_fields:create`	Create the Nova Score and Nova Tags application fields on first connection
`harvest:custom_field_options:create`	Add an option to the Nova Tags field when a new job-specific score label is needed
`harvest:applications:update`	Write the Nova Score and Nova Tags values onto an application
`harvest:notes:create`	Post Nova’s assessment as a note on the candidate
`harvest:candidate_tags:create`	Create a Nova-named tag in your account when it does not exist yet
`harvest:applied_candidate_tags:create`	Apply a Nova-named tag to a candidate
`harvest:applied_candidate_tags:destroy`	Remove a Nova-applied tag from a candidate. This does not delete the tag from your account.
`harvest:applications:move`	Move an application to another stage, only when a recruiter confirms the action in Nova
`harvest:candidates:create`	Create a candidate in Greenhouse when a recruiter adds a sourced candidate from Nova
`harvest:applications:create`	Create that candidate’s application on the job the recruiter chose

Webhook permissions

Permission	Purpose
`harvest:webhooks:list`	Read the webhook subscriptions Nova has registered
`harvest:webhooks:create`	Register a webhook subscription so updates reach Nova promptly
`harvest:webhooks:update`	Keep an existing Nova subscription current
`harvest:webhooks:destroy`	Remove a Nova subscription when it is no longer needed

Nova only manages webhook subscriptions it created.

Frequently asked questions

Does Nova score every applicant?

Nova scores new applicants on the jobs where you have enabled application screening. Nova skips candidates who have already been rejected.

Who can authorize the integration?

A Greenhouse user with the Site Admin permission level. Greenhouse requires Site Admin to authorize a Harvest integration. We recommend authorizing with a service account so the connection belongs to your organization.

Can Nova change a candidate's data?

Nova writes only the fields listed in the table above. It does not edit the rest of a candidate or application record, and it does not delete anything it did not create.

Can Nova delete our candidate tags?

No. Nova can remove a Nova-applied tag from an individual candidate. It cannot delete a tag from your Greenhouse account.

Which user posts Nova's notes?

The Greenhouse account that authorized the connection. When you authorize with a service account, notes are posted by that service account, and Greenhouse decides the name shown in the activity feed.

What happens if the connection stops working?

Nova shows a reconnect prompt in its Greenhouse integration settings. Select it to re-authorize with Greenhouse. If the problem continues, contact nova@dweet.com.

Fraud Detection

How Nova flags fraud risk on applicants

Talent Rediscovery

Search the candidates you already have

Get Started

Scoring

Setup & Settings

More Capabilities

Outbound Search

ATS Integrations

Sourcing Integrations

Account & Billing

Legal

Start your free trial

How Nova works in Greenhouse

Before you start