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

1

Open Settings

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

Settings menu
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
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

​
Getting Company Subdomain

1

Copy Subdomain

In Settings > Company profile, copy the Subdomain.

Company profile

​
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

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