Skip to content

Workable

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 Account Click 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 link Get 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 for your Workable Access token, Workable Subdomain and Authenticated User Email (all required). Generate the token with the steps below. Enter Workable API Access Token

Generating a Workable API Access Token

Warning
  • 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. Enter the Access token, the Workable Subdomain (for https://acme.workable.com, enter acme), and the Authenticated User Email: the email of the Workable user who generated the token. Click Connect Enter Workable API Access Token

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