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

# Ashby

> If you have been directed to StackOne to integrate with Ashby, the following steps will help you understand the process and any necessary actions to configure successful integration.

<Warning>
  The following guidance assumes you have Admin privileges for your Ashby
  account.
</Warning>

## Generating an API Key

<Steps>
  <Step title="Sign-in and open Integrations">
    Sign in to <a href="https://app.ashbyhq.com/signin">your account</a> and click the Admin <Icon icon="gear" iconType="regular" /> button on the top bar.

    In the left menu bar, click on <b>Integrations</b> to expand the menu and then click on <b>API Keys</b>.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Keys page" src="https://mintcdn.com/stackone-hub/GOZmFSdE5jrwxdYf/images/ashby/image1.png?fit=max&auto=format&n=GOZmFSdE5jrwxdYf&q=85&s=9926f9fe80c8b530e1bbdddb60d3d4cf" width="2880" height="1622" data-path="images/ashby/image1.png" />
    </Frame>
  </Step>

  <Step title="Add a new API key">
    Click on the <Icon icon="plus" iconType="regular" /> <b>New</b> button to create a new API Key and name it appropriately.

    <Frame>
      <img className="rounded-md" style={{ width: '400px', margin: '0 auto', border: '1px solid #efefef' }} alt="API Keys page" src="https://mintcdn.com/stackone-hub/GOZmFSdE5jrwxdYf/images/ashby/image2.png?fit=max&auto=format&n=GOZmFSdE5jrwxdYf&q=85&s=ee7a33df4b4b1462afd6907761b3a47f" width="754" height="421" data-path="images/ashby/image2.png" />
    </Frame>
  </Step>

  <Step title="Select the Appropriate API Scopes">
    In Choose API Scopes, select the required permissions for this API Key. For the <b>ATS</b> integration, <b>Read and Write</b> permissions are required for the modules listed below. Enable these selections shown and listed below, then press <b>Save and Continue</b>.

    <Frame>
      <img className="rounded-md" style={{ width: '400px', margin: '0 auto', border: '1px solid #efefef' }} alt="API Key dialog" src="https://mintcdn.com/stackone-hub/GOZmFSdE5jrwxdYf/images/ashby/image3.png?fit=max&auto=format&n=GOZmFSdE5jrwxdYf&q=85&s=f7866b82d3f73798d879bcb672bc6fd7" width="753" height="780" data-path="images/ashby/image3.png" />
    </Frame>

    <ol type="a">
      <li>Jobs</li>
      <li>Candidates</li>
      <li>Interviews</li>
      <li>Hiring Process Metadata</li>
      <li>Organization</li>
      <li>Offers</li>
      <li>Api Keys</li>
      <li>Approvals</li>
      <li>Other Permission Settings: Allow access to confidential jobs?</li>
    </ol>
  </Step>

  <Step title="Copy the API key to clipboard">
    Copy your new API Key to a safe place to be used in the next step. Click <b>Copy and Close</b> in the bottom right once complete.

    <Frame>
      <img className="rounded-md" style={{ width: '400px', margin: '0 auto', border: '1px solid #efefef' }} alt="API Key dialog" src="https://mintcdn.com/stackone-hub/GOZmFSdE5jrwxdYf/images/ashby/image4.png?fit=max&auto=format&n=GOZmFSdE5jrwxdYf&q=85&s=26419a72322a8b1df547f51230d61ade" width="755" height="437" data-path="images/ashby/image4.png" />
    </Frame>
  </Step>
</Steps>

## Use the API Key in the StackOne Hub

Upon reaching the Link Account page, enter the generated API key and proceed by clicking the <b>Connect</b> button.

<Frame>
  <img className="rounded-md" style={{ width: "400px", margin: "0 auto", border: "1px solid #efefef" }} alt="Access Token Created" src="https://mintcdn.com/stackone-hub/GOZmFSdE5jrwxdYf/images/ashby/image5.png?fit=max&auto=format&n=GOZmFSdE5jrwxdYf&q=85&s=59fe5c4879baed87a3c43ca202cea368" width="484" height="388" data-path="images/ashby/image5.png" />
</Frame>

## Useful Links

<Card title="API Reference" icon="link" href="https://developers.ashbyhq.com/reference/introduction">
  [https://developers.ashbyhq.com/reference/introduction](https://developers.ashbyhq.com/reference/introduction)
</Card>