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.
This guidance assumes you have Super Admin privileges for your Workable account.
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
Open Settings
Click on your user initials in the top right menu and open Settings > Apps.
![Settings menu](https://mintlify.s3-us-west-1.amazonaws.com/stackone-hub/images/workable/image1.png)
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://mintlify.s3-us-west-1.amazonaws.com/stackone-hub/images/workable/image2.png)
Generate Token
Click Generate token.
Copy API Key
Copy your newly generated API key to a safe place. Then close the modal.
![API key](https://mintlify.s3-us-west-1.amazonaws.com/stackone-hub/images/workable/image3.png)
Getting Company Subdomain
Copy Subdomain
In Settings > Company profile, copy the Subdomain.
![Company profile](https://mintlify.s3-us-west-1.amazonaws.com/stackone-hub/images/workable/image4.png)
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://mintlify.s3-us-west-1.amazonaws.com/stackone-hub/images/workable/image5.png)
Congratulations, you’re all set! If you face any issues with the steps mentioned above, please contact us by emailing integrations@stackone.com. We’re always here to assist you!
Available data
This integration has the following IAM Resources available from the provider:
- Users
- Roles