> ## 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]
>
> Note that Workable Account Users with the selected permission "Recruiting Member Access: No access" are not retrieved via this integration.

## Generating Workable API key & enabling permissions

**1. Open Settings**

Click on your user initials in the top right menu and open **Settings > Apps**.

![Settings menu](https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image1.png?fit=max\&auto=format\&n=szmML3Ufcn8rAy_V\&q=85\&s=246f0c8fa08f9aa3c5f0683fde9ca0c1)

**2. Generate API Token**

Scroll down and click **Generate API Token**. 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.

![Generate API Token](https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image2.png?fit=max\&auto=format\&n=szmML3Ufcn8rAy_V\&q=85\&s=065a6957fff75c00d6a29a31db31ab22)

**3. Generate Token**

Click **Generate token**.

**4. Copy API Key**

Copy your newly generated API key to a safe place. Then close the modal.

![API key](https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image3.png?fit=max\&auto=format\&n=szmML3Ufcn8rAy_V\&q=85\&s=9b5a7fc74a6235df849f19600575ee4c)

## Getting Company Subdomain

**1. Copy Subdomain**

In **Settings > Company profile**, copy the Subdomain.

![Company profile](https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image4.png?fit=max\&auto=format\&n=szmML3Ufcn8rAy_V\&q=85\&s=369bcfc0f46cec51cad0125eb29dc96c)

## Connect with StackOne

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

![Connect Workable](https://mintcdn.com/stackone-hub/szmML3Ufcn8rAy_V/images/workable/image5.png?fit=max\&auto=format\&n=szmML3Ufcn8rAy_V\&q=85\&s=256cb3b441704710585ea4cc8695a2e8)

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

> **[Authentication Guide](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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.