# Workable

> Source: https://truto.one/docs/integration-guides/workable/

## Install Workable integration

The Workable integration can be found [here](https://app.truto.one/integrations/available/fd705c63-01f0-4a05-9039-06391a586cea). Please install it in your environments before proceeding with the steps below.

## Connecting a Workable account

1. Click on **Connect Account**
   ![Click connect account](https://docs-assets.truto.one/truto-connect-account.png)

2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on **Get connection link**
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)

3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their Workable account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)

4. Select Workable
   ![Select Workable](https://docs-assets.truto.one/select-workable.png)

5. You'll now be asked to key-in in your Workable API Access Token and the subdomain to allow access to Truto. Go through the following steps.
  ![Enter Workable API Access Token](https://docs-assets.truto.one/workable-api-access-token.png)

## Generating a Workable API Access Token

:::callout{type="warning"}
- It's recommended that an administrator of your Workable account generates the API Access Token.
:::

Refer the official Workable documentation to [generate the API Access token](https://workable.readme.io/reference/generate-an-access-token).

The scopes required for the Workable integration are:
- For ATS related functionality
  - `r_jobs`
  - `r_requisitions`
  - `r_offers`
  - `r_candidates`
- For HRIS related functionality
  - `r_employees`
  - `r_account`

If write functionality needs to be added, then add the corresponding write scopes as well, which start with `w_`.

6. Key in the API Access Token and the subdomain and click on **Connect**
   ![Enter Workable API Access Token](https://docs-assets.truto.one/enter-workable-api-access-token.png)

7. _Voila!_ You should now see a connection successful message. You can now close this tab.

8. Go to your Truto account, and you should see the new Workable integration under **Integrated Accounts**. Click on the Account ID to view the details and initiate API calls.