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.

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, r_requisitions.

   
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.

Useful Links

API Reference

https://workable.readme.io/reference/