Connectors / Service / Workable

All-in-one recruiting software for ambitious companies; providing powerful online tools to source and manage candidates, 
wrapped up in an interface that teams actually like to use. (updated: 1620300399183)

Workable

Workable is a hiring platform built to empower hiring teams and in-house recruiters to streamline recruitment. It provides tools to help them find qualified candidates and determine top talents.

Overview

All-in-one recruiting software for ambitious companies; providing powerful online tools to source and manage candidates, wrapped up in an interface that teams actually like to use.

Authentication

When using the Workable connector, the first thing you will need to do is go to your Tray.io account page, and select the workflow you wish to work on. Once in the workflow builder itself, search and drag the Workable connector from the connectors panel (on the left hand side) onto your workflow.

With the new Workable connector step highlighted, in the properties panel on the right, click on the Authenticate tab and 'Add new authentication' (located under the 'Authentication' field).

workable-auth

This will result in a Tray.io authentication pop-up window. The first page will ask you to name your authentication, and state which type of authentication you wish to create ('Personal' or 'Organisational').

As you can see, the next page asks you for your 'Access token' and 'Subdomain' credentials.

workable-popups

In order to get these fields, head to your Workable dashboard. To get you Access Token click on your profile picture on the right top corner and select settings.

workable-auth-step-1

On the next page click on integration tab from the left hand side menu and copy your Access Token.

workable-auth-step-2

Your subdomain can be found in the URL in the Workable platform. So if your URL is https://testing.workable.com/backend, 'testing' would be your subdomain.

Once you have added these fields to your Tray.io authentication popup window, click on the 'Create authentication' button. Go back to your settings authentication field (within the workflow builder properties panel), and select the recently added authentication from the dropdown options now available.

Your connector authentication setup should now be complete.

Workable Trigger

If you wish your workflow to be kicked off by a particular action in Workable, you can use the Workable Trigger.

The Workable trigger allows you to receive notifications and trigger workflows when given events occur associated with the selected trigger operation.

Trigger Operations available:

  • Webhook

When creating a new workflow, click the 'Create new workflow' button in the top right hand corner of your main Tray.io dashboard. When the trigger popup window opens, search and select the Workable trigger. Wait to be redirected to your new workflow and the workflow dashboard itself.

workable-select-trigger

With the new Workable trigger step highlighted, in the properties panel on the right, click on 'New Authentication' which is located under the 'Settings' heading.

workable-auth

This will result in a Tray.io authentication pop-up window. The first page will ask you to name your authentication, and state which type of authentication you wish to create ('Personal' or 'Organisational').

As you can see, the next page asks you for your 'Access Token' and 'Subdomain' credentials.

workable-popups

Follow the instructions above to authenticate your trigger, and select 'Webhook' as the event you want your trigger to listen to (aka the operation), in order to set off the workflow itself:

workable-trigger-operation-options

WEBHOOKS: As this uses a webhook as its operation type, you will also need to integrate it with your Workable account, in order to complete the authentication process.

For this you will need to choose an 'Event' that can be chosen from the dropdown and an 'Account ID' which is the same with the 'Subdomain' you used to create the authentication.

The end result should look similar to the below:

workable-trigger-setup

One way to fire the trigger is to move a candidate to another level in the hiring process in the Workable platform. Once this is done your entire workflow will start.

In order to do this, click on the 'Jobs' tab and then go to 'Applied' candidates.

workable-trigger-move-candidate1

On the next page choose the candidate you want to move to the next level of the interview. In our example, we will move the candidate to 'Move to Phone Screen' section.

workable-trigger-move-candidate2

To trigger the event, the fields in the connector have to be set accordingly. Meaning add a 'Candidate moved' from the 'Event' dropdown. Then for arguments, besides the 'Account ID' that is mandatory and has to be filled in with your 'Subdomain', 'Job ShortCode' has to be the same with the job the candidate applied for and 'Stage slug' has to correspond to the step the candidate was moved in the Workable platform.

workable-trigger-wf

Available Operations

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

All Operations

Latest version:

2.1

Get candidate

Return a candidate by its ID.

Get job

Return a job by its shortcode.

List candidate activities

Return a list of the activity stream of the given candidate.

List candidates

Return a list of candidates.

List candidates DDL

List jobs

Return a list of jobs.

List jobs DDL

List members

Return a list of your account members.

List members DDL

List stages

Return a list of of your recruitment pipeline stages.

List stages DDL

Move candidate

Move the candidate to another stage.

Raw HTTP request (advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.