# Workable

### Overview

Integrating Workable with Introist allows you to sync recruitment data for seamless HR automation. Follow these steps to connect Workable to Introist.

### Prerequisites

* A **Workable API Key** with the following settings:
  * r\_candidates
* Your **Workable subdomain**

Refer to Workable guide on obtaining API credentials: [Workable API Key Guide](https://help.workable.com/hc/en-us/articles/115015785428-Generating-revoking-access-tokens-for-Workable-s-API).

### Connecting Workable to Introist

1. In Introist, navigate to **Data → Data Sources**.
2. Click **Connect Data Source**.
3. Select **Workable** from the list.
4. Give a name to your Data Source. Simply "Workable" works fine.
5. Enter your **API Key**.
6. Enter your **Workable subdomain.**
7. Click **Connect**.

Your Workable account is now connected to Introist.

### Setting up webhooks

If you want to start Introist automations as soon as a candidate is marked hired in Workable, you can set up webhooks using the following steps.

1. Connect Workable to Introist (as instructed above)
2. In Data Sources list view, click the action menu (three dots) on your Workable data source and click "Webhook config".
3. Click "Enable webhooks".
4. Introist creates a basic mapping for data coming from Workable but you probably want to review these together with your Introist specialist.
5. Introist now receives webhooks from Workable and you are ready to start utilizing the data in your automations!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.introist.com/knowledge-base/build/data-sources/workable.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.