> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/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>

<Warning>
  Note that Workable Account Users with the selected permission "Recruiting Member Access: No access" are not retrieved via this integration.
</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-docs-confluence-api-token-update/lMwMaErGDlYR1KkK/images/workable/image1.png?fit=max&auto=format&n=lMwMaErGDlYR1KkK&q=85&s=0aa7ced65594259d0fb1a0da9b2db208" 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 and r\_jobs.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate API Token" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/lMwMaErGDlYR1KkK/images/workable/image2.png?fit=max&auto=format&n=lMwMaErGDlYR1KkK&q=85&s=35d576dca1b4e2cc098d90cd064d75e5" 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-docs-confluence-api-token-update/lMwMaErGDlYR1KkK/images/workable/image3.png?fit=max&auto=format&n=lMwMaErGDlYR1KkK&q=85&s=87572eb791b88934491eb5f0350daa94" 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-docs-confluence-api-token-update/lMwMaErGDlYR1KkK/images/workable/image4.png?fit=max&auto=format&n=lMwMaErGDlYR1KkK&q=85&s=c57db374a7e907dfd464b3326ef3dea8" 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-docs-confluence-api-token-update/lMwMaErGDlYR1KkK/images/workable/image5.png?fit=max&auto=format&n=lMwMaErGDlYR1KkK&q=85&s=d05b8e42a5054fe81bfae404ba54dfb9" width="1316" height="978" data-path="images/workable/image5.png" />
</Frame>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
</ul>

## Useful Links

<Card title="Authentication Guide" icon="link" href="https://workable.readme.io/reference/generate-an-access-token">
  [https://workable.readme.io/reference/generate-an-access-token](https://workable.readme.io/reference/generate-an-access-token)
</Card>