Ashby - How do I link my account?

Last updated: October 5, 2026

Overview

To authenticate Ashby, you will need to provide the following information:

  • API key

This guide will walk you through finding or creating the API key within Ashby.

Prerequisites

  • You must be an Ashby admin to create an API key.

Instructions

Step 1: Create a new API key

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

  2. Navigate to Integrations > API Keys.

  3. Click + New in the upper right corner.

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

  5. 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*

Required if Candidates: Read is not granted

Candidates: Read

Y*

Required if Jobs: Read is not granted

Candidates: Write

N

Needed if writing candidates

Interviews: Read

Y

Hiring Process Metadata: Read

Y

Hiring Process Metadata: Write

N

Needed if writing hiring process metadata

Organization: Read

Y

Offers: Read

Y

Permissions required by Ashby

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

  1. Copy the API key and paste it into the API key field in the linking flow.

    Enter your API key in the linking flow