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

1. Open Settings

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

   
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.

   
3. Generate Token

   Click Generate token.

4. Copy API Key

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

   

Getting Company Subdomain

1. Copy Subdomain

   In Settings > Company profile, copy the Subdomain.

   

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.

Available data

This integration has the following IAM Resources available from the provider:

• Users
• Roles

Useful Links

Authentication Guide

https://workable.readme.io/reference/generate-an-access-token