> ## 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.

# Workable

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

<Warning>
  This guidance assumes you have Super Admin privileges for your Workable account.
</Warning>

## Generating Workable API key & enabling permissions

<Steps>
  <Step title="Open Settings">
    Click on your user initials in the top right menu and open <b>Settings > Apps</b>.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Settings menu" src="https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image1.png?fit=max&auto=format&n=szmML3Ufcn8rAy_V&q=85&s=246f0c8fa08f9aa3c5f0683fde9ca0c1" width="1614" height="1008" data-path="images/workable/image1.png" />
    </Frame>
  </Step>

  <Step title="Generate API Token">
    Scroll down and click <b>Generate API Token</b>. Give the token these minimum permissions:

    * Name - (The SaaS you're creating this API token for - eg: StackOne)
    * Expires in - 1 year (make a note internally that you will have to generate a new token before that time)
    * Scopes - This integration requires minimum scopes:  r\_account, r\_candidates, r\_jobs, w\_account, w\_candidates, r\_requisitions.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate API Token" src="https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image2.png?fit=max&auto=format&n=szmML3Ufcn8rAy_V&q=85&s=065a6957fff75c00d6a29a31db31ab22" width="2584" height="1562" data-path="images/workable/image2.png" />
    </Frame>
  </Step>

  <Step title="Generate Token">
    Click <b>Generate token</b>.
  </Step>

  <Step title="Copy API Key">
    Copy your newly generated API key to a safe place. Then close the modal.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API key" src="https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image3.png?fit=max&auto=format&n=szmML3Ufcn8rAy_V&q=85&s=9b5a7fc74a6235df849f19600575ee4c" width="1668" height="972" data-path="images/workable/image3.png" />
    </Frame>
  </Step>
</Steps>

## Getting Company Subdomain

<Steps>
  <Step title="Copy Subdomain">
    In <b>Settings > Company profile</b>, copy the Subdomain.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Company profile" src="https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image4.png?fit=max&auto=format&n=szmML3Ufcn8rAy_V&q=85&s=369bcfc0f46cec51cad0125eb29dc96c" width="1508" height="998" data-path="images/workable/image4.png" />
    </Frame>
  </Step>
</Steps>

## Connect with StackOne

In StackOne, ensure the Workable integration is enabled. In <b>Accounts > Link Account > Workable</b>, enter the API key and subdomain copied from earlier and click the <b>Connect</b> button.

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Connect Workable" src="https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image5.png?fit=max&auto=format&n=szmML3Ufcn8rAy_V&q=85&s=256cb3b441704710585ea4cc8695a2e8" width="1316" height="978" data-path="images/workable/image5.png" />
</Frame>

## Useful Links

<Card title="API Reference" icon="link" href="https://workable.readme.io/reference/">
  [https://workable.readme.io/reference/](https://workable.readme.io/reference/)
</Card>