Prerequisites

• An active Workable account from which data is to be ingested exists.

• The access token and subdomain are available to authenticate Hevo on your Workable account.

• You are logged in as a Super Admin user to obtain the access token and subdomain. Else, you can obtain these from your account super administrator. Read User Types to know about the different types of user accounts in Workable.

• You are assigned the Team Administrator, Team Collaborator, or Pipeline Administrator role in Hevo to create the Pipeline.

Obtaining the Access Token and Subdomain

You require an access token and subdomain to authenticate Hevo on your Workable account.

Note: You must log in as a Super Admin user to perform these steps.

Perform the following steps to create the access token and obtain the subdomain:

1. Log in to your Workable account.

2. On the Overview page, click the profile in the top right corner, and then select Settings from the drop-down.

   

3. On the Settings page, do the following:

   • Create an access token:

     1. In the left navigation pane, scroll down to the INTEGRATIONS section and click Apps.

        

     2. On the Apps page, scroll down to the API ACCESS TOKENS section and click +Generate API token.

        

     3. On the Generate API token page, specify the following:

        

        • Name: A unique name for your API token.

        • Expires In: The token’s expiration period.

        • API scopes: The API permissions required by Hevo to access your data. To grant the required permissions, select the following scopes for the API token:

          • r_candidates

          • r_jobs

     4. Click Generate token.

     5. Click the Copy icon to copy the API token and save it securely like any other password.

        

   • Obtain the subdomain:

     1. In the left navigation pane, under COMPANY, click Company profile.

        

     2. In the COMPANY PROFILE section, copy the Subdomain and save it securely like any other password.

        

You can use these credentials while configuring your Hevo Pipeline.

Configuring Workable as a Source

Perform the following steps to configure Workable as the Source in your Pipeline:

1. Click PIPELINES in the Navigation Bar.

2. Click + CREATE PIPELINE in the Pipelines List View.

3. In the Select Source Type page, select Workable.

4. In the Configure your Workable Source page, specify the following:

   

   • Pipeline Name: A unique name for the Pipeline, not exceeding 255 characters.

   • Access Token: The access token that you copied from your Workable account.

   • Subdomain: The subdomain from which data is to be ingested.

5. Click TEST & CONTINUE.

6. Proceed to configuring the data ingestion and setting up the Destination.