> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Workable

> Configure data exchange between CloudTalk and Workable to ensure your data stays up to date.

> [!NOTE]
>
> This guide explains how to connect your Workable account with CloudTalk and authenticate the integration.

**User level:** Admin

***

## Before You Start

Before setting up the Workable integration, make sure you have the following ready:

* **A Workable account** with admin access to Settings and Integrations.

* **A Workable API access token** with the required scopes: `r_candidates`, `w_candidates`, and `r_jobs`. You can generate this in Workable under **Settings > Integrations > API Access Tokens**.

* **Your Workable subdomain** which is the first part of your Workable URL. For example, if your URL is `https://cloudtalk.workable.com`, your subdomain is `cloudtalk`.

* **Matching email addresses** meaning the email address you use in CloudTalk must exactly match the email address in your Workable account. If they don't match, synchronization will not work correctly.

## Configure Workable

1. In your Dashboard, go to **Settings** > **Integrations**

2. Locate **Workable** and click **Add**.

![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11791405/a2233eaf7272-screenshot-2025-07-17-at-11-23-35.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=05bd4d46871c8c54153d975f8379464a)

3. Under **Workflow settings**, click on **New authentication**.
4. You’ll be asked to provide:

* Your Authentication Name

* Access Token

* Subdomain

* Partner Client ID (*Optional*, can be requested via [partners@cloudtalk.io](mailto:partners@cloudtalk.io))

![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11791405/58aecc9e1c6b-screenshot-2025-07-18-at-11-26-43.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=4714edc656813640af1968828fe8451c)

***

#### Where to find your Workable Access Token and Subdomain

#### Access Token

1. In Workable, go to **Settings > Integrations**.

2. Scroll to **API Access Tokens**.

3. Click **Generate API token**.

   ![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11791405/b0b7f3649051-screenshot-2025-07-17-at-11-55-00.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=53ce9700f9ae73ae0aa73348639365d3)

4. Fill in the token name, set expiry (e.g., 1 year), and select the required scopes.

   Make sure to include the following scopes: `r_candidates`, `w_candidates`, and `r_jobs`.

5. Click **Generate token**, then copy the access token from the list.

   ![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11791405/a4cac7b99eca-screenshot-2025-07-17-at-11-50-59.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=f0de07c9c0330c599afb5fe98ee9a2e5)

> [!WARNING]
>
> You can learn more about token scopes and management in [this Workable guide](https://help.workable.com/hc/en-us/articles/115015785428-Generating-revoking-access-tokens-for-Workable-s-API).

#### Subdomain

Your Workable subdomain is the first part of your Workable URL.\
For example, if your Workable URL is:

```text theme={"system"}
https://cloudtalk.workable.com
```

Then your subdomain is:

```text theme={"system"}
cloudtalk
```

***

Once authentication is successful, you can:

* Select which CloudTalk numbers should be linked to Workable

* Choose numbers for **calls** and/or **messages (SMS)**

Choose the appropriate numbers and click **Submit** to save.

![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11791405/632c3a4167e0-screenshot-2025-07-17-at-12-37-31.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=cb28c93325ec59a51cf921657c3b108e)

## Disconnect or Remove the Integration

If you no longer want CloudTalk to synchronize data with Workable, you can disable or permanently remove the integration.

To **disable the integration**, go to **Settings > Integrations**, locate the **Workable** integration, and toggle the status from **Active** to **Inactive**.

![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11791405/ec85b254f032-screenshot-2026-04-24-at-11-55-13.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=cf6f472ca20959a79b12ddfd4c2439a6)

To **delete the integration permanently**, open the Workable integration settings, scroll down, click **Delete Integration**, and type **DELETE** to confirm.

![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11791405/8aed4aaa4354-screenshot-2b2025-07-03-2bat-2b11-57-50.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=14550536d0bb91968ad39d73f9b65eb6)

***

*Need help or have a question?* Just reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we’re here for you.


## Related topics

- [Using Workable with CloudTalk](https://help.cloudtalk.io/en/articles/11792909-using-workable-with-cloudtalk.md)
- [Configure Attio](https://help.cloudtalk.io/en/articles/16815852-configure-attio.md)
- [Configure Zoho](https://help.cloudtalk.io/en/articles/3490662-configure-zoho.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.