> ## Documentation Index
> Fetch the complete documentation index at: https://nova.dweet.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ashby Integration

> How to connect Nova with Ashby, configure scoring output, and filter candidates.

<Card title="Start your free trial" icon="calendar" href="https://nova.dweet.com?book-call=true&utm_source=docs&utm_medium=cta&utm_campaign=integration&utm_content=ashby">
  Book a call to get your Nova account set up.
</Card>

## How Nova Works in Ashby

<div style={{ position: 'relative', paddingBottom: 'calc(68.47896440129449% + 41px)', height: '0', width: '100%' }}>
  <iframe src="https://demo.arcade.software/BX1YX5UFQxZKaqk4mWzn?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="How Nova Works in Ashby" frameBorder="0" loading="lazy" allowFullScreen allow="clipboard-write" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', colorScheme: 'light' }} />
</div>

## Setup

### Video Guide

<iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/3491ae9258704481b3b49b5d05fa43af" title="Ashby Integration Setup" frameBorder="0" allowFullScreen />

### Select Ashby from ATS Providers

<Frame>
  <img src="https://mintcdn.com/nova-aee55099/OouzTwo9AH8zfe7F/images/docs/select-ashby.webp?fit=max&auto=format&n=OouzTwo9AH8zfe7F&q=85&s=a1af5d609bc79dfbdb92ee21ae50b80e" alt="Ashby selected in Nova onboarding" width="1964" height="1105" data-path="images/docs/select-ashby.webp" />
</Frame>

### Set Up Your API Key

<Steps>
  <Step title="Navigate to API Keys">
    Go to [Ashby API Keys](https://app.ashbyhq.com/admin/api/keys).
  </Step>

  <Step title="Create a new API key">
    Click **"New"** in the top right corner.
  </Step>

  <Step title="Select integration partner">
    Type **"Nova"** in the Integration Partner dropdown and select it.
  </Step>

  <Step title="Name the key">
    Enter **"Nova"** in the Name field.
  </Step>

  <Step title="Configure API scopes">
    Enable these permissions:

    * **Jobs**: Read
    * **Candidates**: Read, Write
    * **Hiring Process Metadata**: Read, Write
    * **Organization**: Read
    * **Interviews**: Read
  </Step>

  <Step title="Copy the API key">
    Click **"Copy and Close"**.
  </Step>

  <Step title="Connect to Nova">
    Go to Settings > Integrations > Ashby and paste the key.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/nova-aee55099/OouzTwo9AH8zfe7F/images/docs/connect-ashby.webp?fit=max&auto=format&n=OouzTwo9AH8zfe7F&q=85&s=ec248fe19521d5172a7daa397e374d09" alt="Ashby API key input in Nova settings" width="1964" height="1105" data-path="images/docs/connect-ashby.webp" />
</Frame>

## Nova Scores in Ashby

<iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/d1706b984f8546b7879c2f2776154f27" title="Ashby Integration" frameBorder="0" allowFullScreen />

Nova adds a **Nova Score** custom field to each candidate for sorting and filtering. You choose where the detailed assessment appears.

## Recording Method

<Tabs items={["Feedback Forms (Recommended)", "Notes"]}>
  <Tab value="Feedback Forms (Recommended)">
    The assessment appears as structured feedback with an Overall Recommendation field.

    <Frame>
      <img src="https://mintcdn.com/nova-aee55099/OouzTwo9AH8zfe7F/images/docs/ashby/ashby-feedback-format.webp?fit=max&auto=format&n=OouzTwo9AH8zfe7F&q=85&s=e92f62d9b5a8fed980be5e0645451955" alt="Nova feedback form in Ashby" width="4440" height="3252" data-path="images/docs/ashby/ashby-feedback-format.webp" />
    </Frame>

    <Warning>
      Ashby sends email notifications for feedback submissions. Disable these to avoid spam. [Notification settings](https://app.ashbyhq.com/settings/notifications)
    </Warning>
  </Tab>

  <Tab value="Notes">
    The assessment appears as a candidate note. No email notifications triggered.

    <Frame>
      <img src="https://mintcdn.com/nova-aee55099/OouzTwo9AH8zfe7F/images/docs/ashby/ashby-notes-format.webp?fit=max&auto=format&n=OouzTwo9AH8zfe7F&q=85&s=a7be9646880b6e61e99028aba24882df" alt="Nova note in Ashby" width="2960" height="2168" data-path="images/docs/ashby/ashby-notes-format.webp" />
    </Frame>

    Use this if you want notifications for human feedback but not Nova's.
  </Tab>
</Tabs>

Configure during onboarding or anytime in Settings > Integrations > Ashby.

## Feedback Form Setup

<Note>
  Only applies if you chose Feedback Forms as your recording method.
</Note>

<iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/a21dd338f38b49a8a0e037d0c9393cf9" title="Ashby Feedback Form Setup" frameBorder="0" allowFullScreen />

<Steps>
  <Step title="Create form in Ashby">
    Go to [Ashby Feedback Forms](https://app.ashbyhq.com/admin/organizationsettings/feedbackForms) and create a new form.
  </Step>

  <Step title="Keep the Overall Recommendation field">
    Value Select, titled "Overall Recommendation", 1-4 scale.
  </Step>

  <Step title="Keep the Feedback field">
    Rich Text, titled "Feedback".
  </Step>

  <Step title="Add the Nova Score field">
    Number, titled "Nova Score", description "Nova Score out of 10".
  </Step>

  <Step title="Connect to Nova">
    Save in Ashby, then select the form in Nova settings.
  </Step>
</Steps>

### Form Structure Example

<Frame>
  <img src="https://mintcdn.com/nova-aee55099/OouzTwo9AH8zfe7F/images/docs/ashby-feedback-form.webp?fit=max&auto=format&n=OouzTwo9AH8zfe7F&q=85&s=0181adc1e08ecc8c90efea4e371a9da8" alt="Ashby feedback form with Nova Score field" width="3928" height="2210" data-path="images/docs/ashby-feedback-form.webp" />
</Frame>

### Score Mapping

| Nova Score | Ashby Recommendation |
| ---------- | -------------------- |
| 1-3        | 1 - Strong No        |
| 4-5        | 2 - No               |
| 6-7        | 3 - Yes              |
| 8-10       | 4 - Strong Yes       |

## Automatic Candidate Filtering

Nova skips scoring for hired and archived candidates. Only "Active" or "Lead" status candidates are scored.