Ashby Integration with Boon

Last updated: April 2, 2026

Overview

To authenticate Ashby, you will need to provide an API key. This guide will walk you through finding or creating the API key within Ashby.

⁠Learn more about Boon⁠⁠

⁠

Instructions

Step 1: Create a new API key

Sign in to Ashby and click Admin in the top navigation bar

Navigate to Integrations > API Keys

In Ashby, click on Admin > Integrations > API Keys

Ashby

In Ashby, click on + New

Add a name for the new API key, then click "Create API Key"

Grant the following permissions to your API key (Write permissions are only required if you intend to send data to Ashby)

Permission

Required at minimum

Explanation

Jobs: Read

Y

Candidates: Read

Y

Candidates: Write

Y

Needed if writing candidates

Interviews: Read

Y

Hiring Process Metadata: Read

Y

Organization: Read

Y

Offers: Read

Y

Permissions required by Ashby

Step 2 : Custom Source Setup

  1. Go to Admin -> Organization Setup -> Sources

  2. Select or add the source type you want to categorize the source (we recommend using "Referral")

  3. Add the source by expanding the source type.

The source should be “Boon.”

​Once you've picked the source, you're ready create the link.

Navigate to Admin → Integrations → Job Boards and click New Custom Link.

Name the link and select the source:

image.png

Step 3: Copy and paste the API key into the linking flow

Process complete! 🎉

⁠

⁠⁠ ⁠ ⁠