Nova Documentation
Integrations

Greenhouse Integration

Integrating and using Nova with Greenhouse.

Start your free trial

Book a call to get your Nova account set up.

Greenhouse Harvest permissions Nova needs

Harvest permission (as shown in Greenhouse)Required for basic Nova scoring?Why Nova needs this
Applications – Get: Retrieve ApplicationYesLet Nova read a single application so we can access resumes, current stage, and Nova-related custom fields for scoring.
Applications – Get: List ApplicationsYesAllow Nova to sync batches of applications into Nova for continuous scoring and monitoring.
Applications – Patch: Update ApplicationYesLet Nova update custom fields on an application (for example, the Nova Score and Nova Tags fields).
Applications – Post: Move ApplicationYesEnable Nova to move applications between stages when you turn on stage‑based automations.
Candidates – Get: Retrieve CandidateYesLet Nova read an individual candidate profile (name, social links, attachments) to enrich scoring.
Candidates – Get: List CandidatesYesAllow Nova to sync candidates in bulk for rediscovery and cross‑job analysis.
Candidates – Post: Add NoteYesAllow Nova to write a summary note of the assessment directly to the candidate’s activity feed in Greenhouse.
Custom Fields – Get: Get custom fieldsYesLet Nova find existing application custom fields so we don’t create duplicates.
Custom Fields – Post: Create custom fieldYesAllow Nova to create the Nova Score field and the Nova Tags multi‑select field on applications.
Custom Field Options – Get: Custom field optionsYesAllow Nova to read the current options for the Nova Tags field.
Custom Field Options – Post: Create custom field optionsYesEnable Nova to add new tag options (for example, per‑job score bands) to the Nova Tags field.
Jobs – Get: Retrieve JobYesLet Nova read a single job to understand requisition IDs and other metadata tied to each application.
Jobs – Get: List JobsYesAllow Nova to display and sync your open jobs so you can enable Nova scoring per role.
Job Posts – Get: Retrieve Job Post for JobYesAllow Nova to read the job description and application questions for a given job to use as context when scoring.
Job Stages – Get: List Job StagesYesLet Nova read your global stage catalog so we can map Nova workflows onto your Greenhouse pipeline.
Sources – Get: List SourcesYesAllow Nova to read your source list (job boards, referrals, campaigns) so we can show and report on where candidates came from.
Tags – Get: List Candidate TagsYesLet Nova see the library of candidate tags that can be applied in Greenhouse.
Tags – Get: List tags applied to candidateYesAllow Nova to see which tags a specific candidate already has so we don’t duplicate or conflict with existing tags.
Tags – Post: Add New Candidate TagsYesEnable Nova to create Nova‑specific tags (for example, by score band or criteria) in your tag library.
Tags – Put: Add a candidate tagYesAllow Nova to attach the right Nova tags to a candidate after scoring.
Tags – Delete: Remove tag from candidateYesLet Nova remove its own tags from a candidate if you clear Nova data.
Tags – Delete: Remove Candidate TagsYesAllow Nova to clean up obsolete Nova‑specific tags from the global tag library if needed.
Users – Get: Retrieve UserYesLet Nova verify that the configured Greenhouse user is active and has the right level (for example, site admin).
Users – Get: List UsersYesAllow Nova to list eligible users so you can choose which user Nova should “act as” when posting notes and tags.
Activity Feed – Get: Retrieve Activity FeedYesLet Nova read the full candidate activity timeline so we can surface recruiter and interviewer notes alongside Nova’s assessments.
Prospect Pool – Get: List Prospect PoolsYesAllow Nova to discover your prospect pools so we can extend scoring and rediscovery to talent pools, not just active applications.
Prospect Pool – Get: Retrieve Prospect PoolYesLet Nova read details of a specific prospect pool to power pool‑level search and analytics.
Rejection Reasons – Get: List Rejection ReasonsYesAllow Nova to attach structured rejection reasons to candidates for outcome‑based reporting.
Scheduled Interviews – Get: List Interviews for ApplicationYesLet Nova see interview schedules for a given application so we can relate interview outcomes to earlier scores.
Scheduled Interviews – Get: Retrieve InterviewYesAllow Nova to read details of a specific interview (participants, timing) for end‑of‑process evaluation features.
Scheduled Interviews – Get: List InterviewsYesLet Nova see interview patterns across applications when comparing predictions to actual outcomes.
Scorecards – Get: List Scorecards for ApplicationYesAllow Nova to read all scorecards tied to an application so we can compare interviewer feedback to Nova’s scores.
Scorecards – Get: Retrieve ScorecardYesLet Nova pull the full contents of a single scorecard for more detailed side‑by‑side evaluation.

Permission List

  • Activity Feed – Get: Retrieve Activity Feed
    Allows Nova to read the full candidate activity timeline so we can surface recruiter and interviewer notes alongside Nova’s assessments.

  • Applications – Get: Retrieve Application
    Allows Nova to read an individual application so we can access resumes, current stage, and Nova‑related custom fields for scoring.

  • Applications – Get: List Applications
    Allows Nova to pull batches of applications into Nova so we can keep scoring up‑to‑date across your pipelines.

  • Applications – Patch: Update Application
    Allows Nova to update application custom fields (for example, writing the Nova Score and Nova Tags back into Greenhouse).

  • Applications – Post: Move Application
    Allows Nova to move applications between stages when you enable stage‑based automations (for example, moving strong candidates into a “Nova reviewed” stage).

  • Candidates – Get: Retrieve Candidate
    Allows Nova to read an individual candidate profile (name, contact info, social links, attachments) to enrich scoring and context.

  • Candidates – Get: List Candidates
    Allows Nova to sync candidates in bulk so we can support rediscovery and cross‑job analysis.

  • Candidates – Post: Add Note
    Allows Nova to post an assessment summary as a note directly on the candidate’s activity feed in Greenhouse.

  • Custom Fields – Get: Get custom fields
    Allows Nova to find and reuse existing application custom fields so we don’t create duplicates.

  • Custom Fields – Post: Create custom field
    Allows Nova to create the dedicated Nova Score numeric field and the Nova Tags multi‑select field on applications.

  • Custom Field Options – Get: Custom field options
    Allows Nova to read the current options configured for the Nova Tags custom field.

  • Custom Field Options – Post: Create custom field options
    Allows Nova to add new tag options (for example, per‑job score bands) to the Nova Tags custom field.

  • Jobs – Get: Retrieve Job
    Allows Nova to read details for a specific job (including requisition IDs) so we can correctly associate applications and scores.

  • Jobs – Get: List Jobs
    Allows Nova to list your jobs so you can turn Nova scoring on/off per role and see which jobs are connected.

  • Job Posts – Get: Retrieve Job Post for Job
    Allows Nova to read the job description and application questions for a job, which we can use as context when scoring candidates.

  • Job Stages – Get: List Job Stages
    Allows Nova to read your stage catalog so we can map our workflows to your Greenhouse pipeline and support stage‑based automations.

  • Sources – Get: List Sources
    Allows Nova to read your list of sources (job boards, referrals, campaigns) so we can show and report on where candidates came from.

  • Tags – Get: List Candidate Tags
    Allows Nova to read the global library of candidate tags that can be used in Greenhouse.

  • Tags – Get: List tags applied to candidate
    Allows Nova to see which tags a specific candidate already has so we avoid duplicates and respect existing tagging.

  • Tags – Post: Add New Candidate Tags
    Allows Nova to create Nova‑specific tags (for example, tags based on score bands or key criteria) in your tag library.

  • Tags – Put: Add a candidate tag
    Allows Nova to apply the appropriate Nova tags to a candidate after scoring.

  • Tags – Delete: Remove tag from candidate
    Allows Nova to remove its own tags from a candidate if you choose to clear Nova data.

  • Tags – Delete: Remove Candidate Tags
    Allows Nova to clean up obsolete Nova‑specific tags from the global tag library if they’re no longer needed.

  • Users – Get: Retrieve User
    Allows Nova to verify that the configured Greenhouse user is active and has the right level of access (for example, site admin).

  • Users – Get: List Users
    Allows Nova to list eligible users so you can choose which user Nova should “act as” when posting notes and tags.

  • Prospect Pool – Get: List Prospect Pools
    Allows Nova to discover your prospect pools so we can extend scoring and rediscovery to prospects, not just active applications.

  • Prospect Pool – Get: Retrieve Prospect Pool
    Allows Nova to read details of specific prospect pools for pool‑level search and analytics.

  • Rejection Reasons – Get: List Rejection Reasons
    Allows Nova to attach structured rejection reasons to candidates so you can analyze outcomes by reason inside Nova.

  • Scheduled Interviews – Get: List Interviews for Application
    Allows Nova to see interview schedules for a given application so we can relate interview outcomes to earlier Nova scores.

  • Scheduled Interviews – Get: Retrieve Interview
    Allows Nova to read details of a specific interview (participants, timing, etc.) for end‑of‑process evaluation features.

  • Scheduled Interviews – Get: List Interviews
    Allows Nova to understand interview patterns across applications when we compare predictions to actual hiring decisions.

  • Scorecards – Get: List Scorecards for Application
    Allows Nova to read all scorecards tied to an application so we can compare interviewer feedback with Nova’s scores.

  • Scorecards – Get: Retrieve Scorecard
    Allows Nova to pull the full contents of a specific interviewer scorecard for more detailed side‑by‑side evaluation.

Greenhouse Integration - Nova