Skip to content


Install Workable integration

The Workable integration can be found here. Please install it in your environments before proceeding with the steps below.

Connecting a Workable account

  1. Click on Connect AccountClick connect account

  2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection linkGet connection link

  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

  4. Select Workable Select Workable

  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

Generating a Workable API Access Token


  • 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.

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_.

  1. Key in the API Access Token and the subdomain and click on ConnectEnter Workable API Access Token

  2. Voila! You should now see a connection successful message. You can now close this tab.

  3. 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.