Skip to main content
All CollectionsAuthentication GuidesATS
Workable - How do I link my account?
Workable - How do I link my account?

How to link your Workable account

Updated over 6 months ago

Overview

To authenticate your Workable account, you will need to provide the following information:

  • Subdomain

  • API Key

This guide will walk you through finding or creating those credentials within Workable.

Instructions

Step 1: Log in to your Workable Portal

  1. Log in to your Workable portal via your organization’s tenant URL

  2. Click on your profile icon in the upper right-hand corner of any page to open up the dropdown menu. Click Settings

  3. Click Integrations in the left menu

  4. Go to the Access Token section on the page. If you do not have an API key created yet, click Generate new token

  5. Configure Scopes. If you want to limit the scopes that we have access to, please make sure these are added so that we are still able to sync data for the account. These are the minimum scopes required:

    • r_candidates

    • r_jobs

    You may need additional scopes depending on your use case, for example you will need w_candidates if you plan to POST/create candidates

  6. Retrieve your API key

Step 2: Enter information in the linking flow

  1. Back in the linking flow, enter the subdomain that appears when you log into Workable. For example, for company-name.workable.com, please enter company-name. Do not enter the full {companydomain}.workable.com

  2. Enter the API key you retrieved from step 1.6 above

Did this answer your question?